@kerabie/mcp

An MCP server for Kerabie. Connect Claude, Cursor or any MCP client to build with Kerabie and to work with your account.

• Build with Kerabie, no API key needed: search the docs, list REST endpoints, read the TypeScript and React Native SDK types, and get integration guides (typescript, react-native, wordpress, web-widget, rest-api). Answers come from docs bundled in the package, so they match the version you install.
• Work with your account, with an API key: conversations, tickets, contacts, campaigns, the Knowledge Base, analytics, AI tools and the MCP servers your chatbot uses. It is a thin layer over @kerabie/sdk and the /v1 API, so it can do exactly what your key can, and nothing more.

Hosted (nothing to install)

Point your client at the hosted server and send your API key as a Bearer token.

https://mcp.kerabie.com/mcp
Authorization: Bearer ker_live_...

Claude Code

claude mcp add --transport http kerabie https://mcp.kerabie.com/mcp --header "Authorization: Bearer ker_live_..."

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "kerabie": {
      "url": "https://mcp.kerabie.com/mcp",
      "headers": { "Authorization": "Bearer ker_live_..." }
    }
  }
}

Add ?readOnly=true to the URL to leave out every tool that changes data. With no key, only the developer tools are offered. Your key is used for each call and is never stored.

Run it locally

Add the server to your MCP client (Claude Desktop, Cursor, Claude Code):

{
  "mcpServers": {
    "kerabie": {
      "command": "npx",
      "args": ["-y", "@kerabie/mcp"],
      "env": { "KERABIE_API_KEY": "ker_live_..." }
    }
  }
}

Or add it to Claude Code with claude mcp add kerabie --env KERABIE_API_KEY=ker_live_... -- npx -y @kerabie/mcp.

| Variable | | |---|---| | KERABIE_API_KEY | Optional. API key from Settings > Integrations > API Keys. Without it only the developer tools are offered. | | KERABIE_ORG_ID | Optional. Only if the key covers several organisations. | | KERABIE_BASE_URL | Optional. Defaults to https://api.kerabie.com. | | KERABIE_MCP_READ_ONLY | true (or pass --read-only) offers only tools that read. |

To serve it yourself over HTTP, run kerabie-mcp-http (set PORT, and optionally KERABIE_BASE_URL) behind TLS. The endpoint is POST /mcp, with GET /health for health checks.

Safety

An MCP client can use every tool your key allows, including ones that reply to customers or delete things. Tools that change data carry the MCP readOnlyHint: false annotation, and deleting ones destructiveHint: true, so clients can ask before running them. Start read-only, and keep your client's approval prompts on.

API access is on the Pro plan and above.

Documentation

Full tool list and guides: https://kerabie.com/docs/sdks/mcp

License

MIT