Trends, funnels and retention from your PostHog project, and read-only HogQL when the question needs it — answered inside ChatGPT, Claude, Codex or Cursor, next to the campaigns that sent those users. Connect PostHog to Soku once; your AI reads it with your own login, 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
PostHog
Product events, funnels and retention
BigQuery
Datasets, tables and schemas in your warehouse
Stripe
Revenue, subscriptions, invoices and refunds
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.
Sign in to PostHog once from Soku to connect it. After that, every AI app you approve reads it through the same connection, with nothing to install for PostHog 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.
Trends, funnels, retention and HogQL
posthog_query
Runs a read tool from PostHog’s MCP against your project — insight queries for trends, funnels and retention, validated read-only HogQL, and the data schema to write it against.
“Where do users drop off between sign-up and first project?”
“What is week-one retention for users who signed up last month?”
“How many people triggered the checkout event yesterday?”
What your AI is allowed to ask PostHog
posthog_list_tools
PostHog’s live MCP tool catalogue for your project, each tool marked as a read that runs or a change that would need review.
“Which PostHog tools can you use through Soku?”
“Can you run SQL against our PostHog project?”
The PostHog projects this workspace can read
posthog_list_projects
The projects granted to this workspace, so a question runs against the right one.
“Which PostHog projects are connected?”
“Use our production project for this.”
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.