Skip to main content
MCP Integration

AI Assistant Integration

Connect AI assistants like Cursor and Claude Desktop to your BuilderBox data using the Model Context Protocol (MCP).

What is MCP?

MCP (Model Context Protocol) is an open protocol that allows AI assistants to connect to external tools and data sources. With BuilderBox's MCP server, your AI assistant can query your coding stats and get insights into your development workflow.

1

Get Your API Key

You'll need an API key to authenticate with the MCP server

Option 1: Using CLI (Recommended)

builderbox key create -n "MCP Integration"

Option 2: Using Web App

  1. Go to Settings
  2. Navigate to the Integrations section
  3. Click "Create API Key"
  4. Copy your new key
2

Configure Your AI Assistant

Add BuilderBox to your assistant's MCP configuration

C

Cursor

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "builderbox": {
      "transport": "http",
      "url": "https://builder-box.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

Replace <your-api-key> with your actual API key.

A

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

{
  "mcpServers": {
    "builderbox": {
      "transport": "http",
      "url": "https://builder-box.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

On Windows: %APPDATA%\Claude\claude_desktop_config.json

3

Restart Your AI Assistant

Restart to load the new configuration

After adding the configuration, fully quit and restart your AI assistant. You should now be able to ask questions like:

  • " How much did I code today? "
  • " What's my AI vs human coding ratio this week? "
  • " Show me my coding activity for the month "
  • " What languages did I use most this week? "

Available Tools

The BuilderBox MCP server exposes the following tools to your AI assistant:

Coding Stats

get_coding_summary

Get coding activity summary including total time, AI vs human breakdown, and top projects/languages

Parameters: range: today | week | month

get_coding_activity

Get detailed coding activity breakdown by projects, languages, and editors

Parameters: range: today | week | month

Troubleshooting

Connection Failed

Make sure your API key is correct and hasn't been revoked. You can verify your key in Settings → Integrations.

Tools Not Showing

Ensure the JSON configuration is valid (no trailing commas, proper quotes). Restart your AI assistant after making changes.

Authentication Errors

Check that the Authorization header includes "Bearer " before your API key (with a space).

Privacy Note

The MCP server only provides access to your own BuilderBox data. Your AI assistant queries are authenticated with your API key, and you can revoke access at any time by deleting the key in Settings. The MCP server never sends your actual code—only aggregated statistics like time spent and language breakdowns.