MCP Server

ChatBakers MCP server

Run ChatBakers as a native MCP server inside Claude Desktop, Claude Code, ChatGPT, Cursor, Gemini CLI, and more. 12 tools cover the full workflow: list and create topics, add prompts in batch, read the dashboard, manage competitors, export citations, and start async topic generation.

Prerequisites

1

A ChatBakers account with a paid plan (Starter or higher). Trial accounts can only create read-only keys.

2

An API key. Create one at Settings → API keys and copy it — it is shown once.

Hosted MCP over HTTP

The fastest install. Paste one URL and your bearer token into your MCP client. Nothing runs on your machine.

Endpoint: https://app.chatbakers.com/mcp

Claude Desktop

Claude Desktop only reads stdio MCP configs, so we wrap the HTTP endpoint with npx -y mcp-remote. Open Settings → Developer → Edit Config and add:

{
  "mcpServers": {
    "chatbakers": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.chatbakers.com/mcp",
        "--header",
        "Authorization: Bearer cbk_live_YOURKEYSECRET"
      ]
    }
  }
}

Restart Claude Desktop after editing. The 12 ChatBakers tools appear in the tools menu.

Claude Code (CLI)

Claude Code natively speaks HTTP MCP — no proxy needed. Run once:

claude mcp add --transport http chatbakers https://app.chatbakers.com/mcp \
  --header "Authorization: Bearer cbk_live_YOURKEYSECRET"

Claude.ai (web)

Open Settings → Integrations → Add a custom MCP server. Paste the URL, then set the Authorization header to Bearer cbk_live_YOURKEYSECRET.

ChatGPT Desktop

Open Settings → MCP Servers → Add. Use https://app.chatbakers.com/mcp as the URL and add the Bearer authorization header.

Cursor

{
  "mcpServers": {
    "chatbakers": {
      "url": "https://app.chatbakers.com/mcp",
      "headers": {
        "Authorization": "Bearer cbk_live_YOURKEYSECRET"
      }
    }
  }
}

Gemini CLI

Add to ~/.gemini/mcp.yaml:

servers:
  chatbakers:
    transport: http
    url: https://app.chatbakers.com/mcp
    auth:
      bearer: cbk_live_YOURKEYSECRET

Test without a client

Use curl to confirm the wiring before opening your AI client:

curl -sS -X POST 'https://app.chatbakers.com/mcp' \
  -H 'Authorization: Bearer cbk_live_YOURKEYSECRET' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize"}'

A 200 response with serverInfo.transport: "http" confirms everything is working.

Agency master keys

Agencies can use one cbk_agency_live_* key across every client they manage. Generate it under Agency settings → API keys, then add an X-Client-Org-Slug header alongside the Authorization bearer. Switch clients by changing the header value — no need to maintain a separate key per customer.

Available tools

Tool What it does
list_websitesList all tracked websites
list_topicsList topics for a website
create_topicCreate a new topic
update_topicSafe rename — does not affect history
list_promptsList prompts under a topic
create_prompts_batchAdd up to 50 prompts in one call. Confirms before adding more than 5 (billable).
get_dashboardVisibility, sentiment, and citation scores in one call
list_competitorsList tracked competitors
add_competitorAdd a competitor domain
list_citationsPaginated citation export
generate_topicsStart async topic generation, returns a jobId
get_job_statusPoll async job status by jobId

No update_prompt or delete_prompt by design — prompt text is immutable because historical results are tied to it.

Try it

1

"What websites do I have in ChatBakers?"

2

"Show me the dashboard for the first website."

3

"Add three prompts about best email warmup tool — informational intent."

The assistant calls list_websites, get_dashboard, then create_prompts_batch in sequence. A batch of 3 skips the confirmation step.

Agent skills

The tools above are the raw API. Our open-source skill pack teaches your assistant complete workflows on top of them: visibility audits, competitor benchmarks, citation analysis, content gap detection, writer-ready briefs, prioritized GEO action plans, and weekly reports. 20 skills in total, including platform-independent GEO playbooks that work without an API key.

npx skills add chatbakers/skills

Works with Claude Code, Cursor, Codex, and any agent supporting the Agent Skills spec. Browse the skills on GitHub.

Troubleshooting

"Authentication failed"

Double-check the Authorization: Bearer cbk_… header. Regenerate at Settings → API keys.

"This key has read-only scope"

Trial accounts only grant read keys. Activate a paid plan to create write keys.

"Client not found" via agency key

Check the X-Client-Org-Slug header matches a client in /agency/clients and that the client is active.