# ChatbotX

This MCP server for Claude Code connects an agent to a ChatbotX workspace. It exposes API operations as tools the agent can call.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1142 repo stars
- Author: ChatbotXIO
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ChatbotXIO/ChatbotX/tree/HEAD/apps/mcp-server
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/chatbotx

## What it does

The server turns operations from ChatbotX’s OpenAPI spec into MCP tools. Agents get a curated default set; `search_tools` finds operations beyond it, and `call_tool` runs them. The tool set refreshes from the spec without restarting the server.

Changes require approval: after approval, the agent repeats the call with `_confirm: true`. The visible tools are also filtered by token permissions. Remote connections use OAuth 2.1, and only workspace owners or `superAdmin` members can authorize access. The connection URL is `https://app.chatbotx.io/mcp/messages`.

## Requirements
- Remote server: `https://app.chatbotx.io/mcp/messages`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://app.chatbotx.io/mcp/messages
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add mcp-server --url https://app.chatbotx.io/mcp/messages
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "url": "https://app.chatbotx.io/mcp/messages"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "http",
            "url": "https://app.chatbotx.io/mcp/messages"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http mcp-server https://app.chatbotx.io/mcp/messages
```

## When to use it
- find a ChatbotX API operation outside the default tool set
- call an available ChatbotX API operation through an agent
- check token permissions before attempting a change

## Example prompts
- Find a ChatbotX tool to look up a contact by email address.
- Check which ChatbotX operations my token can use.
- Find the ChatbotX operation for this task and ask for approval before making a change.

## Similar
- [Composio](https://affpapa.org/en/nevibecode/mcp/composio.md) — MCP server · 570 installs
- [configuring-connections](https://affpapa.org/en/nevibecode/skills/configuring-connections.md) — skill · 4000 installs
- [One](https://affpapa.org/en/nevibecode/mcp/one.md) — MCP server · ★ 12 repo stars
- [n8n-integration-testing-patterns](https://affpapa.org/en/nevibecode/skills/n8n-integration-testing-patterns.md) — skill · 124 installs
- [build-zoom-phone-integration](https://affpapa.org/en/nevibecode/commands/build-zoom-phone-integration.md) — command · ★ 8052 repo stars
- [api-integration-builder](https://affpapa.org/en/nevibecode/skills/api-integration-builder.md) — skill · 244 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
