Pagesmith MCP Server

Model Context Protocol (MCP) server for Pagesmith — lets AI coding agents (Claude Code, Cursor, Claude Desktop, etc.) pull, edit, and deploy your Pagesmith sites.

Install

Run directly with npx (no install needed) or install globally:

# one-off
npx @pagesmith-ai/mcp

# or global
npm install -g @pagesmith-ai/mcp

Requires Node.js 20 or newer.

Configure

Get an API key at https://app.pagesmith.ai/settings/api-keys and export it:

export PAGESMITH_API_KEY=ps_live_...

Claude Code

claude mcp add pagesmith -- npx -y @pagesmith-ai/mcp
# then set the env var in your shell profile

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "pagesmith": {
      "command": "npx",
      "args": ["-y", "@pagesmith-ai/mcp"],
      "env": {
        "PAGESMITH_API_KEY": "ps_live_..."
      }
    }
  }
}

Cursor / other MCP-compatible clients

Point the client at npx -y @pagesmith-ai/mcp with PAGESMITH_API_KEY in the environment.

Environment variables

| Variable | Description | |---|---| | PAGESMITH_API_KEY | Required. API key from your account. | | PAGESMITH_API_URL | Optional. API base URL. Defaults to https://app.pagesmith.ai/api/external. |

Tools

| Tool | Purpose | |---|---| | pagesmith_list_projects | List your projects with preview, published, and custom domain URLs | | pagesmith_pull | Download project files to ~/.pagesmith/workspaces/<id>/ (or fetch a single file) | | pagesmith_push | Commit and deploy workspace changes; auto-fixes build errors | | pagesmith_deploy | Rebuild preview without file changes | | pagesmith_publish | Publish preview to production | | pagesmith_prompt | Send a natural-language edit request to Pagesmith AI | | pagesmith_history | List commit history | | pagesmith_content_list | List content collections or posts | | pagesmith_content_get | Get a post (frontmatter + body) | | pagesmith_content_create | Create a new post | | pagesmith_content_update | Update a post | | pagesmith_content_delete | Delete a post | | pagesmith_domains | Manage custom domains (list, connect, verify, set-primary, refresh-ssl, remove) | | pagesmith_secrets | List integrations or set environment secrets |

Typical agent workflow

1. pagesmith_list_projects — find the project UUID.
2. pagesmith_pull — download files into the workspace.
3. Read / Edit / Write local files (all paths are constrained to the workspace).
4. pagesmith_push with a commit message — builds, auto-fixes errors, returns a preview URL.
5. pagesmith_publish when ready.

Security notes

• The server only writes under ~/.pagesmith/workspaces/<project-id>/. Paths returned by the API are validated and any attempt to escape the workspace is rejected.
• Requests include a 30s timeout and retry once on HTTP 429 using the Retry-After header.
• Tool inputs are validated (UUID format, non-empty strings, enum values) before calling the API.

Links

• Homepage: https://pagesmith.ai
• CLI: @pagesmith-ai/cli
• MCP spec: https://modelcontextprotocol.io

License

MIT — see LICENSE.