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
| Tool | Description |
|---|---|
get_workspace_details | Get workspace name, plan, and member info |
list_grids | List all Grids with optional search & pagination |
get_grid_details | Fetch a Grid's column schema and row data |
run_grid | Trigger a Grid run (full or selected rows) |
get_run_status | Poll the status of a Grid run |
rotate_api_key | Rotate the workspace API key |
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.
| Endpoint | Method | Tool |
|---|---|---|
/workspace | GET | get_workspace_details |
/grids | GET | list_grids |
/grids/:gridId | GET | get_grid_details |
/grids/:gridId/run | POST | run_grid |
/grids/:gridId/runs/:runId | GET | get_run_status |
/rotate-api-key | POST | rotate_api_key |
⚠️ 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