The datasets in your BigQuery project, the tables and views inside each one, and every column’s name and type — answered inside ChatGPT, Claude, Codex or Cursor, so the person writing the query starts from the real schema. Connect BigQuery to Soku once; your AI reads it with your own credentials, and every read costs 0 credits.
Claude CodeCodexCursorVS CodeChatGPTClaude (web & desktop)Your own agent
Soku Connect
Sign in, connect the account once, paste the setup prompt to your agent, ask something. That’s the whole setup.
Your accounts, one connection
ads, analytics, commerce and revenue
BigQuery
Datasets, tables and schemas in your warehouse
AppsFlyer
Installs, ROAS and retention by media source
PostHog
Product events, funnels and retention
200+
APIs
40+
apps
30+
skills
Ask once and your AI reads the accounts you connected — no paid data call involved.
Your own account0 credits per readRead-only
About five minutes
Set it up once, in the app you already use.
Connect your BigQuery account in Soku once. After that, every AI app you approve reads it through the same connection, with nothing to install for BigQuery itself.
Claude Code
One sign-in covers every project, and headless runs (`claude -p`, CI, the Agent SDK) work without a browser — `claude mcp add` only writes config, so a non-interactive run can never finish the MCP authorization. Both surfaces can act on your accounts once you approve each change.
1
Create your Soku workspace
The connection is public and identical for everyone — your Soku sign-in is what points it at your data. Connect one account in that workspace too: that is what your AI reads. The first time your AI uses the connection, Soku asks you to approve the access and names the workspace it will read through — so the workspace has to exist by then.
Already have one? Nothing to do here — sign in when the connection asks for it.
2
Copy the Soku MCP connection
https://api.soku.ai/mcp
3
Add it to Claude Code
claude mcp add --transport http soku https://api.soku.ai/mcp
Run the command in any project. It writes the configuration and prints an `Added …` line.
Authorize separately — adding a server does not open a browser.
Run `claude mcp list` to confirm the server reads `✔ Connected`.
4
Approve the access, then ask it something
Inside Claude Code, run `/mcp` and follow the browser flow — or, from your shell, `claude mcp login soku`.
The Soku consent page names the host, the workspace the grant will read through, and what the connection will be able to do.
Approving creates the grant listed above on this page. Cancelling creates nothing.
On a machine with no browser (SSH, headless Linux), `claude mcp login soku --no-browser` prints the URL and takes the pasted callback.
Paste this first
Using Soku, search for what capabilities I can reach.
A list of capabilities with names, what each reads and what each costs. An empty list means the search matched nothing — try broader words. An error naming authorization means the host never completed the browser step.
Checked 2026-08-25 against Claude Code documentation. Menu names change between releases — look for connectors, apps, tools or integrations.
Ask in plain English. These are the tools behind the answer.
Each one is a tool your AI is offered by name once you connect. You never have to type the name — it is here so you can tell what actually ran.
The datasets in a project
bigquery_list_datasets
Every dataset the connection can see, with its region — the starting point for knowing what data exists at all.
“What datasets do we have in BigQuery?”
“Which of our datasets are in the EU region?”
The tables and views inside a dataset
bigquery_list_tables
Tables, views, materialised views and external tables in one dataset, each with its type — views are often the curated entry point, and they are listed alongside tables.
“What tables are in our marketing dataset?”
“Is there a view for daily revenue in the analytics dataset?”
Every column’s name and type
bigquery_get_table_schema
A table or view’s columns — name, type and mode, with nested fields one level deep — plus its row and byte counts.
“What columns does the orders table have?”
“How many rows are in the sessions table, and how big is it?”
Pricing
Choose the Soku plan for your research and agent workflow.
Start free, upgrade when your team needs more credits, more brands, or deeper workflow execution.