An MCP server for BigQuery exploration with cost guardrails and a built-in NL→SQL eval harness.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"mcp-bigquery-evals","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# mcp-bigquery-evals > An MCP server for BigQuery exploration with cost guardrails and a built-in NL→SQL eval harness. [](https://pypi.org/project/mcp-bigquery-evals/) [](#eval-harness) [](https://github.com/Umarfarook1/mcp-bigquery-evals/actions/workflows/ci.yml) ## What it is A [Model Context Protocol](https://modelcontextprotocol.io/) server that lets Claude Desktop, Cursor, and Claude Code explore and query a BigQuery warehouse safely. - **7 read-only tools** for warehouse discovery + querying - **Mandatory dry-run cost cap** on every `run_query` (default 100 MB scanned, ≈ $0.0005) - **Built-in eval harness** with result-set-equivalence methodology — every release ships an accuracy number, not a vibe Two clients ship in the box: `RealBigQueryClient` (production) and `FakeBigQueryClient` (in-memory, sqlite-backed; for dev and CI without GCP credentials). ## Quickstart (5 minutes) ### 1. Install ```bash uvx mcp-bigquery-evals --help ``` (Or `pip install mcp-bigquery-evals` if you prefer.) ### 2. Authenticate to GCP ```bash gcloud auth application-default login ``` ### 3. Add to `claude_desktop_config.json` Open Claude Desktop → Settings → Developer → Edit Config, then add: ```json { "mcpServers": { "bigquery": { "command": "uvx", "args": ["mcp-bigquery-evals", "serve"], "env": { "BIGQUERY_PROJECT": "your-personal-gcp-project-id" } } } } ``` Restart Claude Desktop. You should see "bigquery" with 7 tools in the MCP indicator. ### 4. Try it Ask Claude: > "Using the bigquery tool, find the top 5 most-viewed Stack Overflow questions tagged 'python'." Claude will use …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.