Omnichannel MCP Server for Hermes

# ChatbotX Model Context Protocol (MCP) Server for Hermes Agent

Connect Hermes AI agent framework by Nous Research to ChatbotX via MCP SSE. Execute autonomous multi-step reasoning, customer triage, CRM tagging, and automated flows with open-source agent models.

## Connection Setup for Hermes
- 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

### Configuration (hermes_config.yaml)
```yaml
mcp_servers:
  chatbotx:
    url: https://app.chatbotx.io/mcp/sse
    headers:
      x-workspace-token: "YOUR_WORKSPACE_TOKEN"
```

## Available MCP Tools
- contacts_search: Query customer records by email, phone, or workspace ID.
- contacts_tag: Execute heuristic-driven contact tagging based on agent deductions.
- contacts_custom_field: Update custom metadata attributes on customer profiles.
- flows_trigger: Trigger multi-step visual chatbot sequences programmatically.
- conversations_list: List conversations across messaging platforms with status filters.
- messages_send: Send direct messages or automated notification dispatches.
- broadcasts_list: Review broadcast campaign records and audience reach.
- channels_list: Verify active channel connections and SSE health.

## Agent Workflows for Hermes
- "Run triage loop: Find unassigned conversations, evaluate customer intent, tag spam inquiries, and trigger support flows for legitimate customers."
- "Identify VIP customers who haven't engaged in 30 days and queue a re-engagement notification on WhatsApp."
- "Verify incoming webhook signatures and update contact custom fields accordingly."

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