{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_qjduatbdxjm7","handle":"flin-bigquery-mcp","url":"https://wellknown.network/agents/flin-bigquery-mcp","links":{"self":"https://wellknown.network/agents/flin-bigquery-mcp/record.json","html":"https://wellknown.network/agents/flin-bigquery-mcp","markdown":"https://wellknown.network/agents/flin-bigquery-mcp/record.md","api":"https://wellknown.network/api/v1/agents/flin-bigquery-mcp","status":"https://wellknown.network/api/v1/agents/flin-bigquery-mcp/status","claim":"https://wellknown.network/agents/flin-bigquery-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/flin-bigquery-mcp/claim.json","badge":"https://wellknown.network/agents/flin-bigquery-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/flin-bigquery-mcp/history","tools":"https://wellknown.network/api/v1/agents/flin-bigquery-mcp/tools"},"ard":{"identifier":"urn:air::server:flin-bigquery-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"flin-bigquery-mcp","summary":"MCP server for exploring BigQuery and running bounded read-only SQL queries.","description":"# flin-bigquery-mcp\n\nMCP server for exploring Google BigQuery and running bounded, read-only GoogleSQL queries. Follows the Python/FastMCP, desktop OAuth, multi-account token storage and `uv` packaging conventions of [flin Search Console MCP](https://github.com/flin-agency/flin-google-search-console-mcp) and [flin Keyword Planner MCP](https://github.com/flin-agency/flin-google-keyword-planner-mcp).\n\n## Mac installation (Claude Desktop)\n\nDownload `flin-bigquery-mcp-0.1.1-macos.mcpb` from the [GitHub release](https://github.com/flin-agency/flin-bigquery-mcp/releases/latest) and open it with Claude Desktop. You can also use Claude Desktop's local extension installation dialog and select the file.\n\nThe installer asks for your Google Desktop OAuth client ID and secret, default billing project, optional BigQuery location, and maximum bytes billed per query (default 1 GiB). Configure Google Cloud as described below before the first data request. Google sign-in opens in the browser when needed.\n\nThe extension contains a small launcher that checks PyPI on every MCP server start and runs the latest stable `flin-bigquery-mcp` version compatible with Python 3.12. It does not contain a frozen copy of the server. It uses the MCPB `uv` runtime with Python 3.12, supports Apple Silicon and Intel Macs, and needs internet access at startup to check for updates and download changed dependencies. A current Claude Desktop version with `uv` extension support is required. The `.mcpb` is an unsigned local extension, not a notarized macOS application; it does not require administrator access or a separate repository checkout. For other MCP clients, use the PyPI or source configuration below.\n\n### Updates after installation\n\nInstall the new 0.1.1 `.mcpb` once to replace the old 0.1.0 bundle. From then on, fully quit and reopen Claude Desktop after a new PyPI release; the launcher refreshes the package even when an older version is cached. An already running server does not update in the midd…","publisher":null,"homepage":"https://github.com/flin-agency/flin-bigquery-mcp","repository":"https://github.com/flin-agency/flin-bigquery-mcp","version":"0.1.1","license":"MIT","protocols":["mcp"],"tags":["bigquery","claude","google-cloud","mcp"],"pricing":null,"endpoints":[{"url":"pypi:flin-bigquery-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":1,"provenance":"derived"},{"slug":"infra.cloud","name":"Cloud Platforms","confidence":1,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.825,"provenance":"derived"},{"slug":"data.database","name":"Databases","confidence":0.733,"provenance":"derived"}],"categories":["data","dev","infra"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"flin-bigquery-mcp","registry":"pypi","observedAt":"2026-11-05T21:26:39.948Z","publishedAt":"2026-11-02T17:16:15.801101Z","latestVersion":"0.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"flin-bigquery-mcp","url":"https://pypi.org/project/flin-bigquery-mcp/","firstSeenAt":"2026-10-30T19:25:30.775Z","fetchedAt":"2026-11-05T21:25:25.467Z","normalizedAt":"2026-11-05T21:25:25.467Z"}]},"firstSeenAt":"2026-10-30T19:25:30.775Z","updatedAt":"2026-11-05T21:26:39.948Z"}