Pagesmith

MCP Server

Connect Claude, ChatGPT, Claude Code, Codex and other AI apps to Pagesmith. No install and no API key: sign in and choose what the app may do.

MCP (Model Context Protocol) is an open standard that lets AI apps use outside services. The Pagesmith MCP server lets AI apps work with your sites: ask Claude or ChatGPT to look through a site, change a page, write a blog post or publish an update, and it does the work in Pagesmith.

There is nothing to install and no API key to copy. You add one address to your AI app, sign in with Pagesmith and choose what the app may do.

Connector address

https://mcp.pagesmith.ai

This address and the setup steps are also on your workspace's Apps & API page.

Connect your AI app

Claude (web and desktop)

Open Settings → Connectors → Add custom connector and paste the connector address.

ChatGPT

Open chatgpt.com/plugins, choose Add → Add custom MCP server and paste the connector address. Depending on your ChatGPT plan, the option may need to be turned on first.

Claude Code

claude mcp add --transport http pagesmith https://mcp.pagesmith.ai

Then type /mcp in Claude Code and choose Authenticate.

Codex

codex mcp add pagesmith --url https://mcp.pagesmith.ai

Codex asks you to sign in. If it does not, run codex mcp login pagesmith.

Other apps

Any app that supports remote MCP servers with sign-in can use the same address.

What happens when you connect

Your AI app opens a Pagesmith page where you:

  1. Sign in to Pagesmith.
  2. Choose the workspace to connect. The app can only see that workspace's sites.
  3. Choose what the app may do:
    • View sites: projects, files, content and past versions. Always included.
    • Make changes: edit pages, content and files. Asking the Pagesmith AI for a change uses credits. Changes appear in the preview first; your live site stays as it is.
    • Publish sites: put changes live. Off unless you tick it. Published sites count toward your plan's limit.

You can disconnect an app at any time under Connected apps on the Apps & API page. Disconnecting removes access immediately, but does not undo past changes. A connection also ends after 30 days without use.

Connecting apps requires a Pro plan or higher, and only workspace owners can connect apps.

What you can ask

  • "List my Pagesmith sites"
  • "What does the about page on my bakery site say?"
  • "Add a testimonials section to the homepage"
  • "Write a blog post about our summer opening hours"
  • "Show me the preview"
  • "Publish the site"

Publishing and deleting are marked as sensitive actions, so most AI apps ask you to confirm first. Changes always build a preview first.

Tools

Tool What it does Needs
pagesmith_list_projects List your sites with preview and live addresses View sites
pagesmith_list_files List a site's files View sites
pagesmith_read_file Read one file View sites
pagesmith_history Show a site's past versions View sites
pagesmith_content_list List content collections (blog posts, team members and similar) and their entries View sites
pagesmith_content_get Read one post View sites
pagesmith_download_project A short-lived link to the site's whole source code as a zip (Pro plan and up) View sites
pagesmith_request_change Ask the Pagesmith AI for a change in plain words; it edits, builds a preview and fixes build errors Make changes
pagesmith_change_status Check a change: in progress, done (with the preview address and credits used) or failed Make changes
pagesmith_write_files Save exact file changes and build a preview; refuses to overwrite a file that changed since it was read Make changes
pagesmith_upload_image Add an image to the site's media library and return its address to use in a page or post Make changes
pagesmith_content_create Create a post Make changes
pagesmith_content_update Update a post Make changes
pagesmith_content_delete Delete a post Make changes
pagesmith_publish Put the current preview live Publish sites

An app only sees the tools its connection allows.

Adding images

The AI app uploads an image first with pagesmith_upload_image, then uses the returned url (and srcset, when there is one) in pagesmith_write_files or in a post. Uploading adds the image to the site's media library; the live site stays the same until a change uses it.

Give the tool one of these:

  • url: the address of an image on the web.
  • file: a file you attached in the chat.
  • Neither: the tool returns a one-time uploadUrl for a file on your computer. Send the file within 15 minutes with curl -fsS -T <file> <uploadUrl>, and the response contains the image's address.
  • content_base64: the image as base64, for small images under 750 KB when the other ways do not work.

Images can be PNG, JPEG, WebP, GIF or AVIF, up to 10 MB. You can also pass a filename, a media library folder and alt text.

How it works

AI app (Claude, ChatGPT, Claude Code, Codex)
    ↕ MCP over HTTPS, with your Pagesmith sign-in
Pagesmith MCP server (mcp.pagesmith.ai)
    ↕
Your sites (files, preview builds, publishing)

Changes run in the background, the same way as in the Pagesmith editor: the app starts a change, then checks its status until the preview is ready. Every change and publish is recorded for the workspace.

Local MCP server with an API key (for developers)

For tools that cannot connect to a remote MCP server, a local version runs on your computer and uses an API key instead of sign-in. It needs Node.js 20 or later and an API key from the Apps & API page.

Claude Code

claude mcp add pagesmith \
  -e PAGESMITH_API_KEY=ps_live_your_key_here \
  -- npx @pagesmith-ai/mcp

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

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

Replace ps_live_your_key_here with your API key. Keep it private: anyone with the key can view, edit and publish every site in your workspace.

The local server also has tools for downloading a whole site to your computer, managing custom domains and integration secrets.

Variable Description
PAGESMITH_API_KEY Your API key (required)
PAGESMITH_API_URL Custom API URL (optional)

Documentation