pancake-api-mcp

A Model Context Protocol (MCP) server that serves the Pancake API documentation to your AI assistant.

Point Claude Desktop, Cursor, or any MCP client at this server and your AI can read the Pancake docs on its own — search endpoints, pull a single endpoint's full contract (parameters, request body, response schema with every $ref expanded), inspect webhook payloads, and read the authentication / rate-limit / webhook-setup guides — without you copy-pasting anything.

The docs are bundled as a static snapshot of the official OpenAPI spec, so documentation lookups are self-contained and offline.

Optionally, configure your access tokens in the server's environment and the call_endpoint tool can also call the live Pancake API for you — the right token (access_token or page_access_token) is picked from each endpoint's OpenAPI security scheme and attached automatically. Without tokens the server stays fully offline and documentation-only.

What's inside

• 31 REST endpoints across Pages, Conversations, Messages, Statistics, Customers, Posts, Tags, Users, Call logs, Export Data, Page's Contents, and Chat Plugin.

• 5 webhook events: messaging, conversation, post, subscription, connect_status — each with its full payload schema and an example.

• 11 guides: authentication & tokens, rate limits, the recommended API usage flow, webhook setup, event types, suspension rules, and best practices.

Related MCP server: Dedalus MCP Documentation Server

Tools

Every endpoint, webhook, and guide is also exposed as an MCP resource (pancake-api://endpoint/..., pancake-api://webhook/..., pancake-api://guide/...) for clients that browse resources.

Install

Requires Node.js 18+.

git clone https://github.com/<your-org>/pancake-api-mcp.git
cd pancake-api-mcp
npm install
npm run build

This produces dist/index.js, the server entry point.

Configure your access tokens (optional)

Pancake uses two token types, both passed as a query parameter. Set them as environment variables of the MCP server and call_endpoint will attach the right one per endpoint — you never paste a token into a chat, and tokens are never accepted as tool input.

Optional extras:

Ask your assistant to run auth_status to verify the setup — it reports which variables are set without revealing their values.

Writes are enabled by default. With a page token configured, call_endpoint can really send messages to customers, change tags, and delete data. Set PANCAKE_READ_ONLY=true if you only want the assistant to read. Tokens are read from the environment only, redacted from every tool response and error message, and never written to logs.

Connect it to your AI client

Claude Desktop

Edit your claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pancake-api": {
      "command": "node",
      "args": ["/absolute/path/to/pancake-api-mcp/dist/index.js"],
      "env": {
        "PANCAKE_USER_ACCESS_TOKEN": "your-user-access-token",
        "PANCAKE_PAGE_ACCESS_TOKEN": "your-page-access-token",
        "PANCAKE_PAGE_ID": "optional-default-page-id"
      }
    }
  }
}

Drop the env block entirely to run in offline documentation-only mode.

Restart Claude Desktop. You should see the pancake-api tools appear.

Cursor

In Settings → MCP → Add new global MCP server (or edit ~/.cursor/mcp.json):

{
  "mcpServers": {
    "pancake-api": {
      "command": "node",
      "args": ["/absolute/path/to/pancake-api-mcp/dist/index.js"],
      "env": {
        "PANCAKE_PAGE_ACCESS_TOKEN": "your-page-access-token"
      }
    }
  }
}

Replace /absolute/path/to/pancake-api-mcp with the real path where you cloned this repo.

Try it

Once connected, ask your AI things like:

• "Using the Pancake docs, how do I authenticate?"

• "What endpoint lists conversations for a page, and what parameters does it take?"

• "Show me the payload of the messaging webhook."

• "Search the Pancake docs for anything about tags."

And, with tokens configured:

• "Check my Pancake token setup." (auth_status)

• "List the last 60 conversations of page 12345." (call_endpoint)

• "Send 'thanks for your order' to conversation X." (a write — confirm before you say yes)

Development

npm run build     # compile TypeScript to dist/
npm run dev       # tsc --watch
npm run inspect   # open the MCP Inspector against the built server
npm run sync-spec # (maintainer) refresh spec/ from ../pancake_api_doc/openapi

Updating the bundled docs

The OpenAPI snapshot lives in spec/openapi.yaml and spec/webhook.yaml. A maintainer refreshes them from the source docs project with:

npm run sync-spec                        # assumes ../pancake_api_doc alongside this repo
npm run sync-spec -- /path/to/pancake_api_doc   # or pass the docs repo explicitly
npm run build

License

MIT — see LICENSE.