Omnichannel MCP Server for Claude Code

# ChatbotX Model Context Protocol (MCP) Server for Claude Code

Connect Anthropic Claude Code terminal agent to ChatbotX via MCP SSE. Execute customer automation, test chatbot flows, verify webhook deliveries, and query CRM databases directly from your command-line interface.

## Connection Setup for Claude Code
- Protocol: Model Context Protocol (MCP) via Server-Sent Events (SSE)
- Endpoint: https://app.chatbotx.io/mcp/sse
- Authentication: Header "x-workspace-token: <YOUR_WORKSPACE_TOKEN>"
- Documentation: https://chatbotx.io/docs/mcp/introduction

### CLI Registration Command
```bash
claude mcp add chatbotx -t sse -H "x-workspace-token: YOUR_WORKSPACE_TOKEN" -s user https://app.chatbotx.io/mcp/sse
```

## Available MCP Tools
- contacts_search: Query contacts by email (email:[email protected]) or phone (phone:+84...).
- contacts_tag: Add or remove customer segmentation tags programmatically.
- contacts_custom_field: Set or retrieve custom metadata properties on contact records.
- flows_trigger: Trigger visual chatbot flows and automated drip pipelines.
- conversations_list: List conversations filtered by channel (whatsapp, telegram, messenger, etc.) or state.
- messages_send: Dispatch programmatic messages or webhook responses to customers.
- broadcasts_list: Inspect broadcast campaigns, subscriber counts, and delivery metrics.
- channels_list: Verify channel connection status and SSE bridge responsiveness.

## CLI Agent Workflows
```bash
$ claude "Search contact [email protected], verify their WhatsApp connection, and trigger onboarding flow"
$ claude "List recent failed webhook messages across all channels and summarize the error codes"
$ claude "Tag all contacts created today via API as 'Batch_2026_09' and verify CRM sync"
```

## Supported Messaging Channels
WhatsApp, Messenger, Instagram, TikTok, Telegram, Zalo OA, Webchat, SMTP, and API.