Cakemail Knowledge Base MCP

Semantic search over Cakemail documentation via the Model Context Protocol.

What is this?

This is an MCP server that lets AI assistants search Cakemail's knowledge base documentation. It indexes all articles, embeds them for semantic search, and serves results through the MCP Streamable HTTP protocol.

Available Tools

search_knowledge_base

Semantic search over all Cakemail documentation. Supports filtering by language.

list_topics

Browse all available articles and topics in the knowledge base.

Authentication

Two authentication methods are supported:

Basic Auth — use your Cakemail email and password (recommended for MCP clients)
Bearer token — admin API key or a Cakemail access token from /api/auth

Connect with Claude Code

Using your Cakemail credentials (Base64-encode email:password):

claude mcp add cakemail-kb \
  --transport http \
  https://kb.mcp.cakemail.com/api/mcp \
  --header "Authorization: Basic BASE64_ENCODED_CREDENTIALS"

Generate the Base64 string: echo -n 'you@example.com:your-password' | base64

Connect with any MCP client

Add to your MCP client configuration:

{
  "mcpServers": {
    "cakemail-kb": {
      "type": "streamable-http",
      "url": "https://kb.mcp.cakemail.com/api/mcp",
      "headers": {
        "Authorization": "Basic BASE64_ENCODED_CREDENTIALS"
      }
    }
  }
}

Tip: Generate your credentials string by running:
echo -n 'you@example.com:your-password' | base64

Alternatively, you can use Authorization: Bearer API_KEY with an admin API key.

API Endpoints

POST /api/mcp

MCP Streamable HTTP endpoint. Requires Basic Auth or Bearer token.

POST /api/auth

Get an access token with Cakemail credentials. Accepts username, password, and optional account_id. Also supports grant_type: refresh_token.

POST /api/reindex

Trigger reindexing. Use ?full=true for full reindex, ?full=true&lang=en for a single language. Also accepts GitHub webhook push events. Admin API key required.

GET /api/usage

View search usage statistics per user. Optional query params: ?since=2026-03-01&until=2026-03-31. Admin API key required.