Connect BotInbox to AI assistants using the Model Context Protocol (MCP). Let Claude, GPT, and other AI models manage your customer conversations directly.
Go to Settings > API Keys in your BotInbox dashboard and create a new API key. Make sure to grant the permissions you need (conversations, contacts, messages).
Point your MCP-compatible client at the BotInbox MCP endpoint:
POST https://your-domain.com/api/mcp Authorization: Bearer bi_your_api_key_here Content-Type: application/json
Send an initialize request to verify your setup:
{
"method": "initialize"
}Add this to your Claude Desktop claude_desktop_config.json file:
{
"mcpServers": {
"botinbox": {
"url": "https://your-domain.com/api/mcp",
"headers": {
"Authorization": "Bearer bi_your_api_key_here"
}
}
}
}Replace your-domain.com with your actual BotInbox URL and bi_your_api_key_here with your API key.
The MCP endpoint accepts JSON-RPC style requests via POST /api/mcp. Authenticate with your API key in the Authorization: Bearer header.
initialize - Handshake and capability discoverytools/list - List all available tools with schemastools/call - Execute a tool by name with argumentsErrors follow JSON-RPC conventions:
{
"jsonrpc": "2.0",
"id": null,
"error": {
"code": -32601,
"message": "Unknown tool: invalid_tool"
}
}-32700 - Parse error (invalid JSON)-32601 - Method/tool not found401 - Invalid or missing API key403 - Organization suspendedNeed help? Check the REST API docs or contact support.