MCP / Social media
Foreplay MCP
Foreplay competitor ad intelligence: search 200M+ Meta / TikTok / YouTube ads, brand analytics, tracked competitors, swipe file. Connect it to Claude, Codex, Cursor or any MCP client through one FlyMy.AI MCP.
Find up to 10 currently running English-language video ads for warehouse automation and show their hooks and landing pages.
Paste it into an assistant connected to FlyMy.AI. The agent picks the actions.
What Foreplay MCP can do
16 actions in the FlyMy.AI catalog, the most used first. Your agent finds them through search_tools and calls the one the task needs.
| Action | What it does |
|---|---|
foreplay_search_ads | Search the Foreplay ad library (200M+ Facebook, Instagram, TikTok, YouTube, LinkedIn ads) by keywords with filters: date window, live only, format (video, carousel, image), platform, niche... |
foreplay_ad_details | Full details of one Foreplay ad by id: creative, transcript, hooks, copy, landing page, platforms, first/last seen, brand. |
foreplay_ad_duplicates | Ads that reuse the same image or video as a given Foreplay ad (creative variants and iterations of one concept). |
foreplay_board_ads | Ads saved on one Foreplay board by board id with the standard filters; paginate with next_cursor. |
foreplay_boards | The user's Foreplay boards (optionally grouped by folder) with their ids. |
foreplay_brand_ads | All ads of one or more brands by Foreplay brand id with the standard ad filters and ordering (newest, longest_running, most_relevant); collect=true asks Foreplay to fetch live from Meta when its... |
foreplay_brand_analytics | Brand analytics for a competitor (Foreplay brand id or Facebook page id): running ads distribution, media mix, formats, platforms and activity over a date window - the fastest read on how a... |
foreplay_brands_by_domain | Brands behind a website domain (e.g. |
foreplay_explore_brands | Discover brands by the ads they run: filter by niche, platform, format, language, live status or date window and get the brands behind matching ads - a way to find unknown competitors. |
foreplay_page_ads | All ads of a brand by its Facebook page id with the standard ad filters and ordering; collect=true fetches live from Meta when the cache is empty. |
foreplay_search_brands | Find competitor brands in Foreplay by name: brand id, page ids, ad counts. |
foreplay_spyder_brand_ads | Ads of a tracked (Spyder) brand with the standard filters - new launches and creative shifts; paginate with next_cursor. |
Show all 16 actions
| Action | What it does |
|---|---|
foreplay_spyder_brands | Brands the user tracks in Foreplay Spyder (competitor watchlist) with their ids. |
foreplay_spyder_top_ads | Top-ranked ads of a tracked brand's Facebook page for an anchor date, with rank movement versus N days ago - which creatives a competitor is scaling. |
foreplay_swipefile_ads | Ads saved in the user's Foreplay swipe file with the standard filters, ordered by saved_newest by default; offset/limit paging. |
foreplay_usage | Foreplay API usage and remaining quota for the connected account. |
Ask your agent
Requests to paste as they are. Each one runs on the actions named under it.
foreplay_search_adsforeplay_brands_by_domainforeplay_ad_detailsConnect Foreplay in a minute
One MCP for every integration. Add it once, then every MCP in the catalog is a request away.
- 01
Add FlyMy.AI
Add the FlyMy.AI MCP to your assistant with one of the commands below and sign in. No key to copy.
- 02
Add your Foreplay API key
Paste it into the Foreplay connection settings once; it stays with FlyMy.AI, never in a prompt or a chat.
- Foreplay API key - Foreplay dashboard -> Settings -> API. Requires a plan with API access. Open Foreplay ->
- 03
Ask
Paste a request from this page. Every run shows what it cost.
claude mcp add --transport http flymyai https://mcp-agents.flymy.ai/mcp
Then run /mcp in Claude Code and sign in.
codex mcp add flymy --url https://mcp-agents.flymy.ai/mcp
Then run codex mcp login flymy to sign in.
https://mcp-agents.flymy.ai/mcp
Settings, Connectors, Add custom connector: paste this URL.
Pay per run
FlyMy.AI bills the run: the model and the tool's seconds. Calls go to your own Foreplay account, under its plan and limits. No seats and no minimum.
Go to the source
From the FlyMy.AI platform catalog of 2026-10-31: name, description, actions and setup as the platform lists them. Examples are requests to paste, not recorded runs.