Skip to main content
Glama
README.md
# EdgePress MCP server

Connect any MCP-capable AI agent (Claude Code, Claude Desktop, Cursor, VS Code, Codex, Gemini CLI…) to **your** EdgePress site — CMS or store — with a personal access token.

Four tools:

- `ep_request` — call your site's REST API (`/api/v1`), e.g. `GET /posts?limit=3`, `POST /pages`.
- `ep_media_upload` — upload an image, video, audio file or PDF (up to 20MB) from a public URL or base64, into the media library (published with alt text) or onto a store product.
- `ep_page_inspect` — fetch a page as a visitor gets it (a draft through a private noindex preview) and report robots, title, headings, structured data, lang/dir, images missing alt or hot-linked, and broken anchors.
- `ep_api_spec` — look up routes and request bodies in the [OpenAPI spec](https://api-docs.edgepress.cc), scoped to your site's product (CMS or store).

Two prompts: `build-landing-page` (new template, blocks and images, checked through a private preview and stopped at a draft for your review) and `qa-landing-page` (a read-only review before a page goes live).

The token decides what the agent can do: its role, and whether it is `read_only`. Nothing else is granted.

## 1. Create a token

Admin → **API tokens** → New token. It starts with `epat_`. Pick read-only unless the agent should write.

## 2a. Hosted (nothing to install)

Every site serves MCP at `https://<your-site>/api/mcp` (Streamable HTTP).

Claude Code:

```bash
claude mcp add --transport http edgepress https://blog.edgepress.cc/api/mcp \
  --header "Authorization: Bearer epat_..."
```

Cursor / VS Code / other clients (`mcp.json`):

```json
{
  "mcpServers": {
    "edgepress": {
      "url": "https://blog.edgepress.cc/api/mcp",
      "headers": { "Authorization": "Bearer epat_..." }
    }
  }
}
```

### ChatGPT, claude.ai and other OAuth connectors

No token to paste: add a custom connector with the URL `https://<your-site>/api/mcp` and OAuth authentication. You sign in to your site, choose **read & write** or **read-only**, and the connector receives an API token named after it — revoke it any time under Admin → API tokens. (On a store, only admins can approve.)

## 2b. Local (stdio, Node 22+)

For clients that only run local servers (e.g. Claude Desktop):

```json
{
  "mcpServers": {
    "edgepress": {
      "command": "npx",
      "args": ["-y", "github:edgepress-cc/mcp-edgepress"],
      "env": { "EDGEPRESS_TENANT": "blog.edgepress.cc", "EDGEPRESS_TOKEN": "epat_..." }
    }
  }
}
```

## Limits

- Uploads are capped at 20MB; larger videos go through the admin UI.
- `build-landing-page` never publishes the page itself; it hands you the preview link and asks.
- Large responses are truncated at 50k characters; page list endpoints instead.

`src/mcp.js` is a copy of `dispatcher/src/mcp.js` in the EdgePress platform repo — do not edit it here.