Packages

MCP Server

The Model Context Protocol lets AI agents manage your PageKit content directly.

Installation

bash

pnpm add -g @arovi/pagekit-mcp

Quick Start

bash

PAGEKIT_API_KEY=pk_live_... pagekit-mcp

Transports

Stdio (default)

Best for local development and desktop clients.

bash

PAGEKIT_API_KEY=pk_live_... pagekit-mcp

HTTP

bash

PAGEKIT_API_KEY=pk_live_... pagekit-mcp --http
# Runs on http://127.0.0.1:9472/mcp

Client Configuration

Claude Desktop

json

{
  "mcpServers": {
    "pagekit": {
      "command": "pagekit-mcp",
      "env": {
        "PAGEKIT_API_KEY": "pk_live_...",
        "PAGEKIT_API_URL": "http://localhost:4783/api/v1"
      }
    }
  }
}

Cursor

Copy .cursor/mcp.json.example to .cursor/mcp.json:

json

{
  "mcpServers": {
    "pagekit": {
      "command": "pagekit-mcp",
      "env": {
        "PAGEKIT_API_KEY": "pk_live_...",
        "PAGEKIT_API_URL": "http://localhost:4783/api/v1"
      }
    }
  }
}

Available Tools

Tool	Description
`pagekit_list_posts`	List posts with filters
`pagekit_get_post`	Get post by ID or slug
`pagekit_create_post`	Create a new post
`pagekit_update_post`	Update an existing post
`pagekit_delete_post`	Delete a post
`pagekit_list_tags`	List all tags
`pagekit_list_categories`	List all categories
`pagekit_list_authors`	List author profiles
`pagekit_get_author`	Get author by ID or slug
`pagekit_create_author`	Create an author profile
`pagekit_update_author`	Update an author profile
`pagekit_list_media`	List media assets
`pagekit_create_media`	Register a media asset
`pagekit_delete_media`	Delete a media asset
`pagekit_project_info`	Get project info
`pagekit_health`	Check API health

Example Interactions

text

"Create a blog post about our new feature."
"Find all unpublished drafts."
"Update the title of the latest article."
"Publish this post."

Environment Variables

Variable	Required	Default	Description
`PAGEKIT_API_KEY`	Yes	—	Your API key
`PAGEKIT_API_URL`	No	`http://localhost:4783/api/v1`	API base URL (include `/api/v1`)
`PORT`	No	`9472`	HTTP port (with `--http`)