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 toolfare once; your AI reads it with your own login, and every read is free.
1Connect your AI app
Pick the app you use. You do this once, and every API on toolfare is then available in it.
Add toolfare as a connector in Claude
Add to Claudehttps://api.toolfare.ai/mcp
- 1Open Customize → Connectors and choose "Add custom connector".
- 2Paste this URL as the remote MCP server URL.
- 3Leave the OAuth client id and secret under Advanced settings empty.
- 4Complete the browser authorization, then return to your conversation.
Custom connectors are available on Free, Pro, Max, Team and Enterprise. A Free account may hold one custom connector in total.
Claude’s own instructions2What to ask
Copy a prompt into your AI app once you’re connected. It picks the right one of the 43 tools and tells you the price first.
CPA and ROAS by campaign, ad group, ad or day
Spend, clicks, conversions, CPA and ROAS, grouped by one dimension over a date range — read from toolfare’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
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
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
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
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
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.”
Also available (37): Audit every tracked automation setting against the live account · Draft a paused ad from a creative · Download a finished change-log export · Preview how an ad renders · Account status, currency, spend and billing facts · The Pages and identities the account can advertise as · One ad’s live status, creative and tracking · One ad set’s targeting, budget and bidding · One campaign’s live settings and status · Check on a change-log export · Which date ranges have finished syncing · Whether conversion tracking is ready for a conversion campaign · Whether a TikTok Shop can run GMV Max · One GMV Max campaign · The leads a form or an ad collected · One product catalog · One product feed · One Smart+ campaign · The ad accounts your toolfare account can read · Automated rules and what they do · The ads in an account, campaign or ad group · Ad sets, with budget and targeting · The conversion actions the account tracks · Custom audiences · Lead forms and their questions · Pixels, and when each one last fired · Product catalogs · The products in a product set · The product sets in a catalog · The products in a catalog · Saved audiences · Read an entity’s current automation settings · Performance broken down by several dimensions at once · Look up location targeting keys · Search interest targeting · Upload images to the ad account library · Upload a video to the ad account library
1Create an API key
One key and one endpoint for every API on toolfare.
export TOOLFARE_API_KEY='tf_live_…'
2Every tool and its input
Send the tool name and its arguments as JSON; the reply is JSON too.
ads_query_single_dimensionSpend, clicks, conversions, CPA and ROAS, grouped by one dimension over a date range — read from toolfare’s synced copy of the account, so a month answers in one call.
ads_get_insightsThe same report TikTok’s own reporting API serves, at campaign, ad group or ad level, for the metrics and dates you name.
ads_get_smart_plus_material_reportA Smart+ campaign’s overview, or its performance broken down material by material — the answer to which videos the algorithm is actually spending on.
ads_get_gmv_max_reportGMV Max performance by store over a date range, for the metrics and dimensions you ask for.
ads_estimate_audience_sizeAn audience-size estimate for ad-group targeting — locations, ages, gender, languages and interests — so two variants can be compared before either one spends.
ads_list_campaignsThe live campaign list with status and budget, straight from TikTok rather than from the last sync.
ads_audit_ad_automation_inventoryAudit every tracked automation setting against the live accountads_create_adDraft a paused ad from a creativeads_download_change_historyDownload a finished change-log exportads_generate_ad_previewPreview how an ad rendersads_get_account_infoAccount status, currency, spend and billing factsads_get_account_pagesThe Pages and identities the account can advertise asads_get_adOne ad’s live status, creative and trackingads_get_adsetOne ad set’s targeting, budget and biddingads_get_campaignOne campaign’s live settings and statusads_get_change_history_taskCheck on a change-log exportads_get_data_readinessWhich date ranges have finished syncingads_get_deploy_readinessWhether conversion tracking is ready for a conversion campaignads_get_gmv_max_availabilityWhether a TikTok Shop can run GMV Maxads_get_gmv_max_campaignOne GMV Max campaignads_get_leadsThe leads a form or an ad collectedads_get_product_catalog_detailsOne product catalogads_get_product_feed_detailsOne product feedads_get_smart_plus_campaignOne Smart+ campaignads_list_ad_accountsThe ad accounts your toolfare account can readads_list_ad_rulesAutomated rules and what they doads_list_adsThe ads in an account, campaign or ad groupads_list_adsetsAd sets, with budget and targetingads_list_conversion_actionsThe conversion actions the account tracksads_list_custom_audiencesCustom audiencesads_list_lead_formsLead forms and their questionsads_list_pixelsPixels, and when each one last firedads_list_product_catalogsProduct catalogsads_list_product_set_productsThe products in a product setads_list_product_setsThe product sets in a catalogads_list_productsThe products in a catalogads_list_saved_audiencesSaved audiencesads_preview_automation_baselineRead an entity’s current automation settingsads_query_multi_dimensionPerformance broken down by several dimensions at onceads_search_geo_locationsLook up location targeting keysads_search_interestsSearch interest targetingads_upload_imagesUpload images to the ad account libraryads_upload_videoUpload a video to the ad account library
Use it when
- Your TikTok CPA moved and you want the campaign, ad group or ad behind it.
- You run Smart+ and want to know which materials the algorithm is spending on.
- You sell through TikTok Shop and want GMV Max results by store.
- You are choosing between targeting setups and want reach estimates first.
Look elsewhere when
- You want organic TikTok posts or creators. Your ad account only reports on your ads. Use this instead
- You want what competitors run on TikTok. That is an ad library, not your account. Use this instead
- You want to change a bid, pause an ad or create a campaign. Over MCP your AI can only propose new ads, and each one waits for your approval in toolfare.
TikTok Ads directly, or through toolfare
Directly
- TikTok Ads Manager exports, or a Business API app of your own
- An access token to create, rotate and keep away from an agent
- Separate reports for Smart+ and GMV Max
Through toolfare
- Ask in the chat you already use, in plain English
- One toolfare login; no TikTok token handed to an agent
- Smart+, GMV Max and standard campaigns in the same conversation
You get reads, not TikTok Ads Manager. Nothing can be launched, edited or paused through the MCP connection, nothing is monitored for you between questions, and there is no dashboard to share — if you act on the answer, you act in TikTok.
Limits
- The reporting tool reads toolfare’s synced copy of the account. A freshly connected account backfills in stages, and TikTok has no live fallback while it does — an unsynced range is not zero spend.
- Result-style metrics follow each ad group’s optimization goal, so they are not comparable across ad groups with different goals.
- Change history is an export TikTok builds asynchronously; the connection can check on and download an export, but not start one.