# Bot Bridge CC Helper

> Bot Bridge CC Helper is a freemium MCP server for developer tools. Dispatch coding jobs from a bot to Claude Code on your Windows PC and read progress. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Windows, CLI
- **Website:** https://botbridge.dev/cc-helper
- **Repository:** https://github.com/1019666077-bit/botbridge-cc-helper-vscode/tree/HEAD/packages/botbridge-cc-helper-mcp
- **MCP Registry name:** io.github.1019666077-bit/cc-helper
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

This stdio server is only a file bridge. It writes a job into the local Helper's inbox folder and reads state from running, done and control folders, so it is useful only with the separate Windows Bot Bridge CC Helper that actually runs the coding agent. Without that install every tool still answers but reports that nothing is installed. The folder defaults to your home cc-helper directory and can be set with CC_HELPER_HOME.

The Helper runs the Claude Code CLI with your own API key, including DeepSeek, and returns structured results. The free tier runs one task at a time with text push alerts. A Pro tier at $29 a year (early-bird) adds one-tap phone approval of pay or submit blockers, Bark screenshot push, hard token budget caps, stall auto-stop and up to 3 parallel jobs on up to 2 machines.

The project says it is independent of Anthropic. Source is MIT licensed, and a --selftest flag checks the install.

## Features

- **File-based dispatch:** Queues a job into the Helper's inbox.
- **Progress reading:** Reads task state from running and done folders.
- **Stop command:** Writes a stop control file to cancel a job.
- **Task listing:** Lists queued, running and finished jobs.
- **Install check:** Reports whether a Helper install is present.
- **Phone approvals:** Pro lets you approve or cancel blockers from a phone.

## Good for

- Send a coding task from a chat bot to your PC
- Check progress of a long-running job remotely
- Cancel a runaway job
- Cap token spend on unattended runs

## Install

### Claude Code (Terminal)

```sh
claude mcp add cc-helper -- npx -y https://github.com/1019666077-bit/botbridge-cc-helper-vscode/releases/download/v0.1.0-mcpb/botbridge-cc-helper.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "cc-helper": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/1019666077-bit/botbridge-cc-helper-vscode/releases/download/v0.1.0-mcpb/botbridge-cc-helper.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "cc-helper": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/1019666077-bit/botbridge-cc-helper-vscode/releases/download/v0.1.0-mcpb/botbridge-cc-helper.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "cc-helper": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/1019666077-bit/botbridge-cc-helper-vscode/releases/download/v0.1.0-mcpb/botbridge-cc-helper.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "cc-helper": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/1019666077-bit/botbridge-cc-helper-vscode/releases/download/v0.1.0-mcpb/botbridge-cc-helper.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "cc-helper": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/1019666077-bit/botbridge-cc-helper-vscode/releases/download/v0.1.0-mcpb/botbridge-cc-helper.mcpb"
      ]
    }
  }
}
```

## Tools

- `cc_helper_status`: Reports whether a local Helper install is present.
- `cc_helper_dispatch`: Queues a job into the inbox.
- `cc_helper_task_status`: Reads one job's state.
- `cc_helper_list_tasks`: Lists queued, running and finished jobs.
- `cc_helper_stop`: Writes a stop command to cancel a running job.

## FAQ

### Does it work without the Helper?

No; tools answer but report nothing is installed.

### What platform is the Helper?

Windows.

### What does Pro cost?

$29 a year early-bird, per the site.

### How do I test it?

Run npx -y botbridge-cc-helper-mcp --selftest.

### Is Bot Bridge CC Helper free?

Bot Bridge CC Helper has a free plan, with paid plans for more usage or features.

### How do I add Bot Bridge CC Helper to Claude Code?

Run this command in your terminal: claude mcp add cc-helper -- npx -y https://github.com/1019666077-bit/botbridge-cc-helper-vscode/releases/download/v0.1.0-mcpb/botbridge-cc-helper.mcpb

### What are the best alternatives to Bot Bridge CC Helper?

The closest alternatives to Bot Bridge CC Helper are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/bot-bridge-cc-helper
