Ask your AI why your Meta CPA moved.
Spend, CPA and ROAS by campaign, ad set or ad, live delivery with Meta’s own breakdowns, change history and Pixel health — answered inside ChatGPT, Claude, Codex or Cursor. Connect your 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 58 tools and tells you the price first.
CPA and ROAS by campaign, ad set, 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 whole month answers in one call.
- “What was our Meta CPA by campaign last week?”
- “Which ads had the best ROAS over the last 30 days?”
Live delivery, with Meta’s own breakdowns
Up-to-the-minute Insights at account, campaign, ad set or ad level, broken down the way Ads Manager does — age, gender, country, placement.
- “How is this campaign delivering right now?”
- “Break down yesterday’s spend by age and placement.”
Every campaign, as it stands on Meta
The live campaign inventory with status, objective and budget — what is actually running, not what a report last saw.
- “Which Meta campaigns are active, and what are their budgets?”
- “List the campaigns that are paused.”
Who changed what, and when
The ad account’s own activity log: who made each change, to which object, and what it was — the first thing to read when a result moves overnight.
- “Who changed the budget on this campaign this week?”
- “What changed in the account before performance dropped?”
Whether your Pixel signal is healthy
Event stats and match rate for a Pixel or Conversions API dataset, so a CPA spike can be ruled in or out as a tracking problem before anyone touches the ads.
- “Is our Meta Pixel signal quality healthy?”
- “What match rate is our dataset getting?”
What Meta itself recommends
The account’s opportunity score and the recommendations Meta attaches to it, read straight from the Graph API.
- “What does Meta recommend we fix in this account?”
- “What is our account’s opportunity score?”
Also available (52): Audit every tracked automation setting against the live account · Check whether AI-automation settings drifted from what was approved · Draft a paused ad from a creative · Draft an ad creative · Draft paused image ads in an ad set · Upload videos and draft paused ads in an ad set · Estimate the reach of a targeting setup · 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 creative’s content · The creatives attached to one ad · One ad set’s targeting, budget and bidding · One campaign’s live settings and status · Feed and item problems in a product catalog · The Instagram accounts connected to the ad account · One custom conversion · Which date ranges have finished syncing · Whether conversion tracking is ready for a conversion campaign · One lead form, its Page, questions and thank-you page · The leads a form or an ad collected · Whether offline conversions are set up to be received · Whether a Page has a WhatsApp number linked for lead ads · One product catalog · One product feed · The rules on a product feed · Whether an uploaded Meta video is ready to use in an ad · The ad accounts your toolfare account can read · Every creative in the account · Ad labels · 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 · Custom conversions · Posts published by a connected Instagram account · 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 · Look up job, behavior, industry and income 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 whole month answers in one call.
ads_get_insightsUp-to-the-minute Insights at account, campaign, ad set or ad level, broken down the way Ads Manager does — age, gender, country, placement.
ads_list_campaignsThe live campaign inventory with status, objective and budget — what is actually running, not what a report last saw.
ads_get_change_historyThe ad account’s own activity log: who made each change, to which object, and what it was — the first thing to read when a result moves overnight.
ads_get_dataset_qualityEvent stats and match rate for a Pixel or Conversions API dataset, so a CPA spike can be ruled in or out as a tracking problem before anyone touches the ads.
ads_get_opportunity_scoreThe account’s opportunity score and the recommendations Meta attaches to it, read straight from the Graph API.
ads_audit_ad_automation_inventoryAudit every tracked automation setting against the live accountads_audit_creative_automationCheck whether AI-automation settings drifted from what was approvedads_create_adDraft a paused ad from a creativeads_create_ad_creativeDraft an ad creativeads_deploy_image_ads_batchDraft paused image ads in an ad setads_deploy_video_ads_batchUpload videos and draft paused ads in an ad setads_estimate_audience_sizeEstimate the reach of a targeting setupads_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_ad_creativeOne creative’s contentads_get_ad_creativesThe creatives attached to one adads_get_adsetOne ad set’s targeting, budget and biddingads_get_campaignOne campaign’s live settings and statusads_get_catalog_diagnosticsFeed and item problems in a product catalogads_get_connected_instagram_accountsThe Instagram accounts connected to the ad accountads_get_custom_conversionOne custom conversionads_get_data_readinessWhich date ranges have finished syncingads_get_deploy_readinessWhether conversion tracking is ready for a conversion campaignads_get_lead_formOne lead form, its Page, questions and thank-you pageads_get_leadsThe leads a form or an ad collectedads_get_offline_conversion_readinessWhether offline conversions are set up to be receivedads_get_page_whatsapp_destinationWhether a Page has a WhatsApp number linked for lead adsads_get_product_catalog_detailsOne product catalogads_get_product_feed_detailsOne product feedads_get_product_feed_rulesThe rules on a product feedads_get_videoWhether an uploaded Meta video is ready to use in an adads_list_ad_accountsThe ad accounts your toolfare account can readads_list_ad_creativesEvery creative in the accountads_list_ad_labelsAd labelsads_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_custom_conversionsCustom conversionsads_list_instagram_mediaPosts published by a connected Instagram accountads_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_search_targetingLook up job, behavior, industry and income targetingads_upload_imagesUpload images to the ad account libraryads_upload_videoUpload a video to the ad account library
Use it when
- Your Meta CPA or ROAS moved and you want the campaign, ad set or ad that moved it.
- You want delivery right now, or broken down by age, gender, country or placement.
- Something changed overnight and you need to know who changed it.
- You suspect tracking rather than creative, and want Pixel signal quality before touching the ads.
Look elsewhere when
- You want what your competitors are running. Your ad account only knows your own ads — ask an ad library instead. Use this instead
- You want what happened after the click. That is your analytics account. Use this instead
- You want to change a budget or pause an ad. Over MCP your AI can only propose new ads, and each one waits for your approval in toolfare.
Meta Ads directly, or through toolfare
Directly
- Ads Manager exports, or a Marketing API app of your own
- A token to create, rotate and keep away from an agent
- Your own code to join spend to conversions
Through toolfare
- Ask in the chat you already use, in plain English
- One toolfare login; no Meta token handed to an agent
- CPA and ROAS already computed, not a CSV to pivot
You get reads, not 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 need to act on the answer, you act in Meta.
Limits
- The reporting tool reads toolfare’s synced copy of the account. A freshly connected account backfills in stages, so an older date range can still be syncing — which is not the same as zero spend.
- Live reads go through Meta’s own API and are subject to its rate limits.
- Only accounts you connected are readable; nothing outside that grant is.