Deterministic SQL compiler for AI agents. Your agent stops guessing SQL.
Connect Runs on your machine
claude mcp add boyce -e BOYCE_DB_URL=<BOYCE_DB_URL> -e BOYCE_PROVIDER=<BOYCE_PROVIDER> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx boyce==0.1.1
{
"mcpServers": {
"boyce": {
"command": "uvx",
"args": [
"boyce==0.1.1"
],
"env": {
"BOYCE_DB_URL": "<BOYCE_DB_URL>",
"BOYCE_PROVIDER": "<BOYCE_PROVIDER>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}
{
"mcpServers": {
"boyce": {
"command": "uvx",
"args": [
"boyce==0.1.1"
],
"env": {
"BOYCE_DB_URL": "<BOYCE_DB_URL>",
"BOYCE_PROVIDER": "<BOYCE_PROVIDER>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}
{
"servers": {
"boyce": {
"type": "stdio",
"command": "uvx",
"args": [
"boyce==0.1.1"
],
"env": {
"BOYCE_DB_URL": "<BOYCE_DB_URL>",
"BOYCE_PROVIDER": "<BOYCE_PROVIDER>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
BOYCE_DB_URLOptional | PostgreSQL or Redshift connection string. Optional — tools work without live DB; required for live profiling and EXPLAIN pre-flight. |
BOYCE_PROVIDEROptional | 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_KEYOptional | 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. |
Details
| Package | [email protected] (PYPI, stdio) |
| First published | 22 Apr 2026 |
| Last updated | 22 Apr 2026 |
| Registry name | io.github.boyce-io/boyce |
More ai and media servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
