Data toolfare buys · quoted firstAsk your AI what your competitors are running, and for how long.
Search a library of running ads by advertiser, keyword, network and format, and see each creative with its copy, how long it has been live and its engagement — answered inside ChatGPT, Claude, Codex or Cursor. No Foreplay seat or API credits of your own: toolfare buys each call and quotes it first.
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 2 tools and tells you the price first.
Live ads, searched by advertiser, keyword or format
Running ads matching an advertiser, keyword, network and media type, each with its asset, copy, how long it has been running and its engagement.
- “What ads is this competitor running right now?”
- “Find video ads about skincare on Facebook.”
- “Which of their angles have been running longest?”
Everything one advertiser is running
Resolves an advertiser or Meta page to its advertiser profile and the ad library attached to it.
- “Show me everything this company is advertising.”
- “Pull this advertiser’s full ad 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.
foreplay_discover_adsRunning ads matching an advertiser, keyword, network and media type, each with its asset, copy, how long it has been running and its engagement.
foreplay_brandResolves an advertiser or Meta page to its advertiser profile and the ad library attached to it.
Use it when
- You want to see what ads a competitor is currently running.
- You are building a swipe file or looking for creative inspiration.
- You want the angles that have run longest — the closest outside proxy for what is working.
Look elsewhere when
- You want your own ad performance. That is in your ad accounts, free, with real spend and conversions. Use this instead
- You want a competitor’s LinkedIn or Google Search ads. That is a different ad library. Use this instead
- You want organic social posts rather than paid ads. Use this instead
Foreplay directly, or through toolfare
Directly
- A Foreplay subscription plus its API credit add-on
- An API key of your own to hand to an agent
- A swipe-file tool you log into separately
Through toolfare
- Per call, quoted before it runs, on the same balance as everything else
- No Foreplay seat and no key to hand to an agent
- Competitor ads beside your own ad accounts in the same question
You get ad library searches, not Foreplay. There are no boards, no saved swipe files, no briefs and no shared team space — every answer is a fresh, charged search.
Limits
- An ad library shows what ran, not what it spent or converted — engagement and run length are proxies.
- Every result page is charged per ad, so wide searches add up.
- Pay as you go from your toolfare balance, in US dollars; there is no subscription. A call runs when your balance covers its quote.
