KosmoKrator

data

Google BigQuery MCP Gateway for AI Agents

Expose Google BigQuery tools to Claude Code, Cursor, Codex, and other MCP clients through the local KosmoKrator MCP gateway.

Google BigQuery MCP Gateway

Expose Google BigQuery to MCP clients with `kosmokrator mcp:serve --integration=google-bigquery`.

If the client has never used KosmoKrator before, install it first, then register this integration as a stdio MCP server.

Install KosmoKrator
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash
Install gateway entry
kosmokrator mcp:gateway:install --integration=google-bigquery --write=deny --json
MCP configuration
{
  "mcpServers": {
    "kosmokrator-google-bigquery": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=google-bigquery",
        "--write=deny"
      ]
    }
  }
}
Serve manually
kosmokrator mcp:serve --integration=google-bigquery --write=deny

Client Notes

Use one scoped MCP gateway entry, then adapt the config location to the client or framework.

Claude Code Connect local KosmoKrator integrations to Claude Code through one scoped MCP gateway entry. Claude Code can launch the local kosmo binary directly from the project MCP config.
Cursor Expose selected local integrations to Cursor through KosmoKrator without configuring each service as its own MCP server. Use the same KosmoKrator install and integration credentials that power terminal and headless runs.
Codex Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy. Keep write access denied or ask-based unless the workspace is trusted.
OpenAI Agents SDK Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway. Use headless JSON commands for CI-style execution and MCP for agent tool discovery.
Claude Agent SDK Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server. Use a narrow integration list so the agent does not load unrelated tools.
Vercel AI SDK Use KosmoKrator as a local integration gateway for Vercel AI SDK agents and scripts. Prefer CLI JSON calls when a workflow only needs one deterministic integration operation.
LangChain Bridge LangChain agents to local KosmoKrator integration tools through MCP or headless CLI calls. Keep the gateway scoped to the integration and operation class needed by the chain.
LangGraph Run KosmoKrator integration calls from LangGraph nodes while preserving local credentials and permissions. Headless CLI calls fit repeatable graph edges; MCP fits exploratory agent nodes.
CrewAI Expose KosmoKrator integrations to CrewAI workers as scoped local tools. Use per-worker integration scopes to avoid giving every worker every tool.
Generic MCP Clients Connect any stdio-compatible MCP client to local KosmoKrator integration tools. Start with read-only write policy and expand only for trusted projects.

MCP Tool Names

KosmoKrator exposes integration tools through the gateway with stable names.

MCP toolSource functionType
integration__google_bigquery__google_bigquery_datasets_delete google-bigquery.google_bigquery_datasets_delete Write write
integration__google_bigquery__google_bigquery_datasets_get google-bigquery.google_bigquery_datasets_get Read read
integration__google_bigquery__google_bigquery_datasets_insert google-bigquery.google_bigquery_datasets_insert Write write
integration__google_bigquery__google_bigquery_datasets_list google-bigquery.google_bigquery_datasets_list Read read
integration__google_bigquery__google_bigquery_datasets_patch google-bigquery.google_bigquery_datasets_patch Write write
integration__google_bigquery__google_bigquery_datasets_undelete google-bigquery.google_bigquery_datasets_undelete Write write
integration__google_bigquery__google_bigquery_datasets_update google-bigquery.google_bigquery_datasets_update Write write
integration__google_bigquery__google_bigquery_jobs_cancel google-bigquery.google_bigquery_jobs_cancel Write write
integration__google_bigquery__google_bigquery_jobs_delete google-bigquery.google_bigquery_jobs_delete Write write
integration__google_bigquery__google_bigquery_jobs_get google-bigquery.google_bigquery_jobs_get Read read
integration__google_bigquery__google_bigquery_jobs_get_query_results google-bigquery.google_bigquery_jobs_get_query_results Read read
integration__google_bigquery__google_bigquery_jobs_insert google-bigquery.google_bigquery_jobs_insert Write write
integration__google_bigquery__google_bigquery_jobs_list google-bigquery.google_bigquery_jobs_list Read read
integration__google_bigquery__google_bigquery_jobs_query google-bigquery.google_bigquery_jobs_query Write write
integration__google_bigquery__google_bigquery_models_delete google-bigquery.google_bigquery_models_delete Write write
integration__google_bigquery__google_bigquery_models_get google-bigquery.google_bigquery_models_get Read read
integration__google_bigquery__google_bigquery_models_list google-bigquery.google_bigquery_models_list Read read
integration__google_bigquery__google_bigquery_models_patch google-bigquery.google_bigquery_models_patch Write write
integration__google_bigquery__google_bigquery_projects_get_service_account google-bigquery.google_bigquery_projects_get_service_account Read read
integration__google_bigquery__google_bigquery_projects_list google-bigquery.google_bigquery_projects_list Read read
integration__google_bigquery__google_bigquery_routines_delete google-bigquery.google_bigquery_routines_delete Write write
integration__google_bigquery__google_bigquery_routines_get google-bigquery.google_bigquery_routines_get Read read
integration__google_bigquery__google_bigquery_routines_get_iam_policy google-bigquery.google_bigquery_routines_get_iam_policy Write write
integration__google_bigquery__google_bigquery_routines_insert google-bigquery.google_bigquery_routines_insert Write write
integration__google_bigquery__google_bigquery_routines_list google-bigquery.google_bigquery_routines_list Read read
integration__google_bigquery__google_bigquery_routines_set_iam_policy google-bigquery.google_bigquery_routines_set_iam_policy Write write
integration__google_bigquery__google_bigquery_routines_test_iam_permissions google-bigquery.google_bigquery_routines_test_iam_permissions Write write
integration__google_bigquery__google_bigquery_routines_update google-bigquery.google_bigquery_routines_update Write write
integration__google_bigquery__google_bigquery_row_access_policies_batch_delete google-bigquery.google_bigquery_row_access_policies_batch_delete Write write
integration__google_bigquery__google_bigquery_row_access_policies_delete google-bigquery.google_bigquery_row_access_policies_delete Write write
integration__google_bigquery__google_bigquery_row_access_policies_get google-bigquery.google_bigquery_row_access_policies_get Read read
integration__google_bigquery__google_bigquery_row_access_policies_get_iam_policy google-bigquery.google_bigquery_row_access_policies_get_iam_policy Write write
integration__google_bigquery__google_bigquery_row_access_policies_insert google-bigquery.google_bigquery_row_access_policies_insert Write write
integration__google_bigquery__google_bigquery_row_access_policies_list google-bigquery.google_bigquery_row_access_policies_list Read read
integration__google_bigquery__google_bigquery_row_access_policies_test_iam_permissions google-bigquery.google_bigquery_row_access_policies_test_iam_permissions Write write
integration__google_bigquery__google_bigquery_row_access_policies_update google-bigquery.google_bigquery_row_access_policies_update Write write
integration__google_bigquery__google_bigquery_tabledata_insert_all google-bigquery.google_bigquery_tabledata_insert_all Write write
integration__google_bigquery__google_bigquery_tabledata_list google-bigquery.google_bigquery_tabledata_list Read read
integration__google_bigquery__google_bigquery_tables_delete google-bigquery.google_bigquery_tables_delete Write write
integration__google_bigquery__google_bigquery_tables_get google-bigquery.google_bigquery_tables_get Read read
integration__google_bigquery__google_bigquery_tables_get_iam_policy google-bigquery.google_bigquery_tables_get_iam_policy Write write
integration__google_bigquery__google_bigquery_tables_insert google-bigquery.google_bigquery_tables_insert Write write
integration__google_bigquery__google_bigquery_tables_list google-bigquery.google_bigquery_tables_list Read read
integration__google_bigquery__google_bigquery_tables_patch google-bigquery.google_bigquery_tables_patch Write write
integration__google_bigquery__google_bigquery_tables_set_iam_policy google-bigquery.google_bigquery_tables_set_iam_policy Write write
integration__google_bigquery__google_bigquery_tables_test_iam_permissions google-bigquery.google_bigquery_tables_test_iam_permissions Write write
integration__google_bigquery__google_bigquery_tables_update google-bigquery.google_bigquery_tables_update Write write

Write Access

Start with --write=deny for read-only MCP clients. Use --write=ask or --write=allow only when the client and workspace are trusted.