BitScale MCP Server

Connect your BitScale workspace to Claude via the Model Context Protocol (MCP).

Setup

1. Install uv (one-time)

macOS / Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. Add to Claude Desktop config

Open ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows) and add:

{
  "mcpServers": {
    "bitscale": {
      "command": "uvx",
      "args": ["bitscale-mcp"],
      "env": {
        "BITSCALE_API_KEY": "your_api_key_here"
      }
    }
  }
}

3. Restart Claude Desktop

That's it. No cloning, no pip install — uvx pulls and runs the package automatically.

Tools

Usage Examples

"List all my BitScale grids"

"Run the Leads Enrichment grid"

"What columns does my Outbound grid have?"

"Check the status of run xyz456 on grid abc123"

Claude Code

claude mcp add bitscale \
  --command uvx \
  --args bitscale-mcp \
  --env BITSCALE_API_KEY=your_api_key_here

API Reference

Requests hit https://api.bitscale.ai/api/v1, authenticated via X-API-KEY. Default rate limit: 5 req/s per workspace.

⚠️ API Key Rotation

Calling rotate_api_key immediately invalidates the current key. Update BITSCALE_API_KEY in your config and restart Claude Desktop after rotating.

License

MIT