Boyce MCP Server

by boyce-ioio.github.boyce-io/boycev0.1.1

Deterministic SQL compiler for AI agents. Your agent stops guessing SQL.

1Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Slowing6mo ago

Install Boyce MCP server

claude mcp add boyce -- uvx boyce

{
  "mcpServers": {
    "boyce": {
      "command": "uvx",
      "args": [
        "boyce"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "boyce": {
      "command": "uvx",
      "args": [
        "boyce"
      ]
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "boyce": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "boyce"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "boyce": {
      "command": "uvx",
      "args": [
        "boyce"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Variable	Required	Secret	Description
BOYCE_DB_URL	—	—	PostgreSQL or Redshift connection string. Optional — tools work without live DB; required for live profiling and EXPLAIN pre-flight.
BOYCE_PROVIDER	—	—	LLM provider for the NL→StructuredFilter planner (anthropic, openai). MCP hosts using their own model should not set this — the host's model does the reasoning and Boyce receives a pre-built StructuredFilter.
ANTHROPIC_API_KEY	—	—	Required only when BOYCE_PROVIDER=anthropic and the host does not supply its own model. MCP hosts (Claude Desktop, Cursor, Claude Code, Codex, Cline, Windsurf, JetBrains) do not need this.