Ask your AI which TikTok creatives are actually converting.
CPA and ROAS by campaign or ad, TikTok’s integrated reports, Smart+ performance by creative material, GMV Max results by store and audience-size estimates — answered inside ChatGPT, Claude, Codex or Cursor. Connect your TikTok ad account 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
TikTok Ads
Spend, results, Smart+ and GMV Max reporting
LinkedIn Ads
B2B campaign and creative performance
ChatGPT Ads
Campaign, landing-page and UTM reporting
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 TikTok Ads once from Soku to connect it. After that, every AI app you approve reads it through the same connection, with nothing to install for TikTok Ads 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.
CPA and ROAS by campaign, ad group, ad or day
ads_query_single_dimension
Spend, clicks, conversions, CPA and ROAS, grouped by one dimension over a date range — read from Soku’s synced copy of the account, so a month answers in one call.
“What was our TikTok CPA by campaign last week?”
“Which TikTok ads had the lowest cost per conversion this month?”
TikTok’s integrated report, live
ads_get_insights
The same report TikTok’s own reporting API serves, at campaign, ad group or ad level, for the metrics and dates you name.
“How did this TikTok campaign deliver yesterday?”
“Pull spend, clicks and conversions by ad group for the last 7 days.”
Which Smart+ materials are carrying the campaign
ads_get_smart_plus_material_report
A Smart+ campaign’s overview, or its performance broken down material by material — the answer to which videos the algorithm is actually spending on.
“Which creatives in our Smart+ campaign get the most spend?”
“Break down this Smart+ campaign’s results by material.”
GMV Max results for your TikTok Shop
ads_get_gmv_max_report
GMV Max performance by store over a date range, for the metrics and dimensions you ask for.
“How did our GMV Max campaigns perform last week?”
“Compare GMV Max results across our stores this month.”
How many people a targeting setup reaches
ads_estimate_audience_size
An audience-size estimate for ad-group targeting — locations, ages, gender, languages and interests — so two variants can be compared before either one spends.
“How big is the audience for women 25–34 in the US interested in skincare?”
“Which of these two targeting setups reaches more people?”
Every campaign, as it stands on TikTok
ads_list_campaigns
The live campaign list with status and budget, straight from TikTok rather than from the last sync.
“Which TikTok campaigns are running right now?”
“List our paused TikTok campaigns and their budgets.”
And 34 more, same connection
Named rather than worked through — your AI discovers all of them through the connection itself, so you never have to pick one.
Audit every tracked automation setting against the live accountads_audit_ad_automation_inventory
Download a finished change-log exportads_download_change_history
Preview how an ad rendersads_generate_ad_preview
Account status, currency, spend and billing factsads_get_account_info
The Pages and identities the account can advertise asads_get_account_pages
One ad’s live status, creative and trackingads_get_ad
One ad set’s targeting, budget and biddingads_get_adset
One campaign’s live settings and statusads_get_campaign
Check on a change-log exportads_get_change_history_task
Which date ranges have finished syncingads_get_data_readiness
Whether conversion tracking is ready for a conversion campaignads_get_deploy_readiness
Whether a TikTok Shop can run GMV Maxads_get_gmv_max_availability
One GMV Max campaignads_get_gmv_max_campaign
The leads a form or an ad collectedads_get_leads
One product catalogads_get_product_catalog_details
One product feedads_get_product_feed_details
One Smart+ campaignads_get_smart_plus_campaign
The ad accounts this workspace can readads_list_ad_accounts
Automated rules and what they doads_list_ad_rules
The ads in an account, campaign or ad groupads_list_ads
Ad sets, with budget and targetingads_list_adsets
The conversion actions the account tracksads_list_conversion_actions
Custom audiencesads_list_custom_audiences
Lead forms and their questionsads_list_lead_forms
Pixels, and when each one last firedads_list_pixels
Product catalogsads_list_product_catalogs
The products in a product setads_list_product_set_products
The product sets in a catalogads_list_product_sets
The products in a catalogads_list_products
Saved audiencesads_list_saved_audiences
Read an entity’s current automation settingsads_preview_automation_baseline
Performance broken down by several dimensions at onceads_query_multi_dimension
Look up location targeting keysads_search_geo_locations
Search interest targetingads_search_interests
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.