{
 "kind": "mcp",
 "slug": "io-chatbotx-mcp",
 "path": "mcp/servers/io-chatbotx-mcp/",
 "name": "ChatbotX",
 "maker": "ChatbotXIO",
 "density": "full",
 "crumbs": [
  [
   "MCP servers",
   "mcp/"
  ],
  [
   "Commerce and payments",
   "mcp/commerce/"
  ]
 ],
 "lead": "run chat marketing from your AI assistant.",
 "chips": [
  {
   "label": "Commerce and payments",
   "path": "mcp/commerce/"
  },
  {
   "label": "Official"
  },
  {
   "label": "Remote"
  }
 ],
 "primary": {
  "label": "Copy connect command",
  "copy": "claude mcp add chatbotx -t http -s user \\\n  \"https://app.chatbotx.io/mcp/messages\"\n"
 },
 "links": [
  {
   "label": "GitHub",
   "href": "https://github.com/ChatbotXIO/ChatbotX"
  },
  {
   "label": "Website",
   "href": "https://chatbotx.io"
  }
 ],
 "track": "New versions and outages of the remote endpoint on your dashboard",
 "verdicts": [
  {
   "key": "official",
   "label": "Made by",
   "value": "The service itself",
   "status": "yes",
   "sub": "Official server",
   "quote": "The production endpoints are `https://app.chatbotx.io/mcp/messages` for Streamable HTTP and `https://app.chatbotx.io/mcp/sse` for legacy SSE",
   "note": "The server lives in apps/mcp-server of the ChatbotXIO/ChatbotX monorepo, the product's own code, and the remote runs on app.chatbotx.io, the vendor's domain.",
   "src": "https://github.com/ChatbotXIO/ChatbotX/blob/d50c84a5cad67917cc294e5aebebb59f028a452c/apps/mcp-server/README.md"
  },
  {
   "key": "secrets",
   "label": "Keys",
   "value": "1 secret needed",
   "status": "info",
   "sub": "CHATBOTX_API_KEY",
   "quote": null,
   "note": "Claude Code and Cursor configs are from the server README (browser sign-in, no token); the Codex config is from the official docs page and uses a workspace token. CHATBOTX_API_KEY is only for the local (stdio) setup.",
   "src": null
  },
  {
   "key": "where",
   "label": "Runs",
   "value": "Remote",
   "status": "yes",
   "sub": "Nothing runs on your machine",
   "note": "Endpoint: https://app.chatbotx.io/mcp/messages. Checked: yes: an unauthenticated HEAD to https://app.chatbotx.io/mcp/messages answered 401 (sign-in required).",
   "src": "https://app.chatbotx.io/mcp/messages"
  },
  {
   "key": "license",
   "label": "Commercial use",
   "value": "With conditions",
   "status": "cond",
   "sub": "Custom license license",
   "quote": "Content outside of the above mentioned directories or restrictions above is available under the MIT license as defined below.",
   "note": "The server code is MIT; the apps/builder/src/enterprise folder of the same repo has a commercial license.",
   "src": "https://github.com/ChatbotXIO/ChatbotX/blob/d50c84a5cad67917cc294e5aebebb59f028a452c/LICENSE"
  }
 ],
 "vfoot": "Checked against its repository at one commit, on Nov 10, 2026.",
 "blocks": [
  {
   "id": "overview",
   "nav": "Overview",
   "h2": "What ChatbotX does",
   "parts": [
    {
     "t": "prose",
     "text": "ChatbotX is a chat marketing platform for WhatsApp, Messenger, Instagram, Telegram, email and more. This server lets your AI assistant find contacts, send messages, start automated chats and read campaign numbers in your ChatbotX workspace. Every change waits for your yes before it goes through."
    },
    {
     "t": "h3",
     "text": "What people use it for"
    },
    {
     "t": "uses",
     "items": [
      {
       "title": "Manage leads by just asking",
       "text": "Ask your assistant to find new leads, update their details, add tags or put them into a follow-up series, without opening the dashboard.",
       "idea": false
      },
      {
       "title": "Route new chats to the right flow",
       "text": "Your assistant reads a conversation, works out what the customer wants and starts the matching automated chat, or hands it to a person on your team.",
       "idea": false
      },
      {
       "title": "Build and check chat flows",
       "text": "Draft a new automated chat in your code editor, check it against the official format, and publish it only when it passes.",
       "idea": false
      },
      {
       "title": "Weekly campaign numbers",
       "text": "Get a short report on new contacts, blocked contacts, and how your broadcasts, flows and follow-up series performed.",
       "idea": false
      },
      {
       "title": "Connect a self-hosted ChatbotX",
       "text": "If you run ChatbotX on your own server, your assistant starts the helper on your computer and talks to your own instance with a workspace token.",
       "idea": false
      },
      {
       "title": "Clean up contacts before a campaign",
       "text": "Before a big send, have your assistant list contacts without a key tag or field, and fix them one by one with your approval.",
       "idea": true
      }
     ]
    }
   ]
  },
  {
   "id": "popularity",
   "nav": "Popularity",
   "h2": "ChatbotX popularity",
   "parts": [
    {
     "t": "stats",
     "items": [
      {
       "n": "1,136",
       "l": "GitHub stars, ChatbotXIO/ChatbotX"
      },
      {
       "n": "0",
       "l": "public agent projects connect it"
      }
     ]
    }
   ]
  },
  {
   "id": "tools",
   "nav": "Tools",
   "h2": "Tools it gives your agent (55)",
   "parts": [
    {
     "t": "tools",
     "items": [
      {
       "name": "search_tools",
       "text": "Searches the full ChatbotX catalog for a tool that is not in the default list; runs nothing"
      },
      {
       "name": "call_tool",
       "text": "Runs any tool by name, including deletes and other actions not in the default list"
      },
      {
       "name": "get_guide",
       "text": "Reads a built-in safety guide for approvals, flows, inbox handover, contacts or pipelines"
      },
      {
       "name": "capabilities_get",
       "text": "Lists workspace channels, templates, tags, fields and flows, with the IDs other tools need"
      },
      {
       "name": "schemas_flow_spec",
       "text": "Returns the format that flow drafts must follow"
      },
      {
       "name": "token_get",
       "text": "Shows the workspace, read-only or full permission, and scopes of the current token"
      },
      {
       "name": "ai_agents_list",
       "text": "Lists AI agents"
      },
      {
       "name": "ai_agents_create",
       "text": "Creates an AI agent"
      },
      {
       "name": "ai_agents_update",
       "text": "Updates an AI agent"
      },
      {
       "name": "ai_files_list",
       "text": "Lists AI files"
      },
      {
       "name": "ai_functions_list",
       "text": "Lists AI functions"
      },
      {
       "name": "analytics_new_contact_counts_per_day",
       "text": "New contacts per day"
      },
      {
       "name": "analytics_blocked_contacts_per_day",
       "text": "Blocked contacts per day"
      },
      {
       "name": "analytics_flow_stats",
       "text": "Flow statistics"
      },
      {
       "name": "analytics_broadcast_stats",
       "text": "Broadcast statistics"
      },
      {
       "name": "analytics_sequence_step_stats",
       "text": "Statistics per step of a follow-up series"
      },
      {
       "name": "broadcasts_list",
       "text": "Lists broadcasts"
      },
      {
       "name": "broadcasts_get",
       "text": "Reads one broadcast"
      },
      {
       "name": "broadcasts_stop",
       "text": "Stops a running broadcast"
      },
      {
       "name": "connections_create",
       "text": "Connects a channel or integration; for the api provider it returns a one-time secret"
      },
      {
       "name": "connection_providers_list",
       "text": "Lists channel and integration providers"
      },
      {
       "name": "connect_sessions_get",
       "text": "Reads a connect session"
      },
      {
       "name": "contacts_create",
       "text": "Creates a contact"
      },
      {
       "name": "contacts_get",
       "text": "Reads a contact by id, email or phone"
      },
      {
       "name": "contacts_list",
       "text": "Lists contacts"
      },
      {
       "name": "contacts_list_tags",
       "text": "Lists a contact's tags"
      },
      {
       "name": "contacts_add_tags_by_name",
       "text": "Adds tags to a contact by name"
      },
      {
       "name": "contacts_list_custom_fields",
       "text": "Lists a contact's custom fields"
      },
      {
       "name": "contacts_set_custom_field",
       "text": "Sets a custom field value on a contact"
      },
      {
       "name": "contacts_list_messages",
       "text": "Lists messages for a contact"
      },
      {
       "name": "contacts_send_message",
       "text": "Sends a message to a contact on a real channel"
      },
      {
       "name": "contacts_send_flow",
       "text": "Sends an automated flow to a contact"
      },
      {
       "name": "contacts_list_sequences",
       "text": "Lists a contact's follow-up series"
      },
      {
       "name": "contacts_subscribe_sequences",
       "text": "Subscribes a contact to follow-up series"
      },
      {
       "name": "conversations_list",
       "text": "Lists conversations"
      },
      {
       "name": "conversations_get",
       "text": "Reads a conversation"
      },
      {
       "name": "conversations_assign",
       "text": "Assigns or unassigns a conversation to a user or team"
      },
      {
       "name": "error_logs_list",
       "text": "Lists error logs"
      },
      {
       "name": "flows_list",
       "text": "Lists flows"
      },
      {
       "name": "flows_get",
       "text": "Reads a flow"
      },
      {
       "name": "flows_create",
       "text": "Creates a flow"
      },
      {
       "name": "flows_update_draft",
       "text": "Updates a flow draft"
      },
      {
       "name": "flows_publish",
       "text": "Publishes a flow so it goes live"
      },
      {
       "name": "flows_validate",
       "text": "Checks a flow draft without publishing"
      },
      {
       "name": "keywords_list",
       "text": "Lists keyword auto-replies"
      },
      {
       "name": "messages_list",
       "text": "Lists messages in a conversation"
      },
      {
       "name": "mini_apps_list",
       "text": "Lists Mini Apps"
      },
      {
       "name": "mini_apps_create",
       "text": "Creates a Mini App"
      },
      {
       "name": "pipelines_list",
       "text": "Lists sales pipelines"
      },
      {
       "name": "pipelines_list_items",
       "text": "Lists pipeline items"
      },
      {
       "name": "pipelines_create_item",
       "text": "Creates a pipeline item"
      },
      {
       "name": "pipelines_move_item",
       "text": "Moves an item to another stage"
      },
      {
       "name": "sequences_list",
       "text": "Lists follow-up series"
      },
      {
       "name": "sequences_get",
       "text": "Reads a follow-up series"
      },
      {
       "name": "sequences_update",
       "text": "Renames or turns a follow-up series on or off"
      }
     ]
    }
   ]
  },
  {
   "id": "data",
   "nav": "Data and license",
   "h2": "What it sends and its license",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Sends",
       "v": "Every tool call with its arguments (contact details, message text, flow drafts)",
       "sub": "To app.chatbotx.io (or your own instance's API); each tool call. Opt out: self-host ChatbotX and point CHATBOTX_API_URL at your own instance."
      },
      {
       "l": "Sends",
       "v": "Messages and flows to your customers",
       "sub": "To WhatsApp, Messenger, Instagram, Telegram and the other connected channels; when contacts_send_message, contacts_send_flow or a broadcast runs. Opt out: use a read-only token."
      }
     ]
    },
    {
     "t": "prose",
     "text": "The code is free to use, change and sell under the MIT license, except one enterprise folder under a commercial license. Using the hosted ChatbotX service is a separate paid or free plan."
    },
    {
     "t": "rows",
     "rows": [
      {
       "l": "In a paid app",
       "v": "With conditions",
       "status": "cond",
       "sub": "The server code is MIT; the apps/builder/src/enterprise folder of the same repo has a commercial license.",
       "quote": "Content outside of the above mentioned directories or restrictions above is available under the MIT license as defined below.",
       "src": "https://github.com/ChatbotXIO/ChatbotX/blob/d50c84a5cad67917cc294e5aebebb59f028a452c/LICENSE"
      },
      {
       "l": "client-work",
       "v": "With conditions",
       "status": "cond",
       "sub": "Fine for client work with the MIT notice kept; the client needs their own ChatbotX workspace and plan.",
       "quote": "The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.",
       "src": "https://github.com/ChatbotXIO/ChatbotX/blob/d50c84a5cad67917cc294e5aebebb59f028a452c/LICENSE"
      }
     ]
    }
   ]
  },
  {
   "id": "alive",
   "nav": null,
   "spy_as": "data",
   "h2": "Is it alive",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Latest version",
       "v": "1.8.1 in the registry, updated Nov 6, 2026"
      },
      {
       "l": "Last release",
       "v": "chatbotx-mcp 1.20.0 on npm, 2026-11-09; repo commit d50c84a on 2026-11-10"
      },
      {
       "l": "Remote endpoint",
       "v": "yes: an unauthenticated HEAD to https://app.chatbotx.io/mcp/messages answered 401 (sign-in required)",
       "status": "yes"
      }
     ]
    }
   ]
  },
  {
   "id": "alternatives",
   "nav": "Alternatives",
   "h2": "Alternatives",
   "parts": [
    {
     "t": "alts",
     "items": [
      {
       "name": "ChatbotX",
       "me": true,
       "facts": [
        "1,136 stars",
        "Remote"
       ]
      },
      {
       "name": "com-relaticle-crm",
       "why": "Pick it if you want an open-source CRM for companies, people and deals without chat channels",
       "path": null,
       "facts": [
        "Local"
       ]
      },
      {
       "name": "mcp",
       "why": "Pick it if the task is payments, invoices or customers in Stripe",
       "path": "mcp/servers/com-stripe-mcp/",
       "facts": [
        "2,072 stars",
        "Remote"
       ]
      }
     ],
     "more": "All commerce and payments servers",
     "more_path": "mcp/commerce/"
    }
   ]
  },
  {
   "id": "start",
   "nav": "Get started",
   "h2": "Get started",
   "parts": [
    {
     "t": "prompt",
     "text": "Connect the ChatbotX MCP server at https://app.chatbotx.io/mcp/messages, call capabilities_get and token_get first, and show me every CONFIRMATION_REQUIRED response before you repeat a call with _confirm."
    },
    {
     "t": "h3",
     "text": "Connect it"
    },
    {
     "t": "tabs",
     "label": "Connect by client",
     "items": [
      {
       "tab": "Claude Code",
       "code": "claude mcp add chatbotx -t http -s user \\\n  \"https://app.chatbotx.io/mcp/messages\"\n"
      },
      {
       "tab": "Cursor",
       "code": "{\n  \"mcpServers\": {\n    \"chatbotx\": {\n      \"type\": \"http\",\n      \"url\": \"https://app.chatbotx.io/mcp/messages\"\n    }\n  }\n}\n"
      },
      {
       "tab": "Any client (JSON)",
       "code": "{\n  \"mcpServers\": {\n    \"chatbotx\": {\n      \"url\": \"https://app.chatbotx.io/mcp/messages\"\n    }\n  }\n}"
      }
     ]
    },
    {
     "t": "small",
     "text": "Claude Code and Cursor configs are from the server README (browser sign-in, no token); the Codex config is from the official docs page and uses a workspace token. CHATBOTX_API_KEY is only for the local (stdio) setup."
    },
    {
     "t": "h3",
     "text": "Mistakes to avoid"
    },
    {
     "t": "mistakes",
     "items": [
      {
       "dont": "Put the workspace token in the connector URL (?workspace_token=...) for Claude Code or Cursor",
       "fix": "Use https://app.chatbotx.io/mcp/messages with browser sign-in; keep tokens for the local stdio setup only",
       "why": "Tokens in URLs end up in logs and shell history; the hosted endpoint signs in through the browser."
      },
      {
       "dont": "Repeat a CONFIRMATION_REQUIRED call with _confirm true on your own",
       "fix": "Show the proposed action and current state to the user and repeat only after a clear yes",
       "why": "The server does not stop a repeated call; the approval is the agent's job."
      },
      {
       "dont": "search_tools with a whole user request in another language",
       "fix": "search_tools with one English action plus one resource, e.g. \"add tag to contact\"",
       "why": "The search ranks English tool names and descriptions and does not translate."
      },
      {
       "dont": "call_tool with every field wrapped in body, params or input",
       "fix": "Pass the fields flat at the top level of arguments, as the tool's inputSchema declares them",
       "why": "The pre-flight check rejects wrapped arguments."
      },
      {
       "dont": "Drop the response of connections_create with provider api",
       "fix": "Save secret.token from that response right away",
       "why": "The token is shown once and cannot be fetched again."
      }
     ]
    }
   ]
  },
  {
   "id": "faq",
   "nav": "Questions",
   "h2": "Questions",
   "parts": [
    {
     "t": "faq",
     "items": [
      {
       "q": "Do I have to paste a secret key into my assistant?",
       "a": "No for the hosted server. Claude Code, Cursor and ChatGPT sign in through the browser; a workspace token is only needed for the local or self-hosted setup.",
       "evidence": {
        "url": "https://github.com/ChatbotXIO/ChatbotX/blob/d50c84a5cad67917cc294e5aebebb59f028a452c/apps/mcp-server/README.md",
        "quote": "Legacy workspace tokens remain supported for stdio and existing connections."
       }
      },
      {
       "q": "Why does my assistant not see a delete tool?",
       "a": "Deletes and less common actions are left out of the default list. The assistant finds them with search_tools and runs them with call_tool.",
       "evidence": {
        "url": "https://github.com/ChatbotXIO/ChatbotX/blob/d50c84a5cad67917cc294e5aebebb59f028a452c/apps/mcp-server/README.md",
        "quote": "ChatbotX's public API has ~350 operations."
       }
      },
      {
       "q": "Can I connect one assistant to two workspaces?",
       "a": "One connection acts on one workspace, chosen at sign-in. To switch, disconnect and connect again.",
       "evidence": {
        "url": "https://github.com/ChatbotXIO/ChatbotX/blob/d50c84a5cad67917cc294e5aebebb59f028a452c/apps/mcp-server/README.md",
        "quote": "The user picks the target workspace on the consent screen, and every token the client holds acts on that workspace; to switch, disconnect and connect again."
       }
      },
      {
       "q": "Which Node.js version does the local setup need?",
       "a": "Node.js 24 or newer.",
       "evidence": {
        "url": "https://github.com/ChatbotXIO/ChatbotX/blob/d50c84a5cad67917cc294e5aebebb59f028a452c/apps/mcp-server/README.md",
        "quote": "Node.js >= 24"
       }
      }
     ]
    }
   ]
  }
 ],
 "glance": [
  [
   "Registry name",
   "io.chatbotx/mcp"
  ],
  [
   "Category",
   "Commerce and payments"
  ],
  [
   "Version",
   "1.8.1"
  ],
  [
   "Remote endpoint",
   "https://app.chatbotx.io/mcp/messages"
  ],
  [
   "License",
   "Custom license"
  ],
  [
   "GitHub",
   "ChatbotXIO/ChatbotX"
  ],
  [
   "In the registry since",
   "Nov 6, 2026"
  ],
  [
   "Works with",
   "Claude Code, OpenAI Codex, OpenCode, LangChain, n8n, LangGraph"
  ]
 ],
 "good": [
  "You need a ChatbotX workspace, and only its owner or a super admin can approve the connection.",
  "The confirmation step is a safety habit, not a lock. The assistant can skip it by sending the confirm flag, so keep an eye on what it sends.",
  "Sending messages, flows and broadcasts reaches real customers on real channels. Deleting things is possible through the hidden full list of actions."
 ],
 "checked_line": "Read by AgentGid from 10 pages and files at one commit, checked Nov 10, 2026; stars update daily.",
 "logo": "https://agentgid.com/media/avatars/chatbotxio.png"
}