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
A ChatBakers account with a paid plan (Starter or higher). Trial accounts can only create read-only keys.
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.
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_websites | List all tracked websites |
| list_topics | List topics for a website |
| create_topic | Create a new topic |
| update_topic | Safe rename — does not affect history |
| list_prompts | List prompts under a topic |
| create_prompts_batch | Add up to 50 prompts in one call. Confirms before adding more than 5 (billable). |
| get_dashboard | Visibility, sentiment, and citation scores in one call |
| list_competitors | List tracked competitors |
| add_competitor | Add a competitor domain |
| list_citations | Paginated citation export |
| generate_topics | Start async topic generation, returns a jobId |
| get_job_status | Poll 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
"What websites do I have in ChatBakers?"
"Show me the dashboard for the first website."
"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.