# Foreplay MCP for AI Agents | FlyMy.AI > Foreplay MCP for Claude, Codex and Cursor through FlyMy.AI. Foreplay competitor ad intelligence: search 200M+ Meta / TikTok / YouTube ads, brand analytics... Page: https://flymy.ai/mcp/foreplay/ 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. [Connect Foreplay](https://flymy.ai/mcp/foreplay/#connect) [What it can do](https://flymy.ai/mcp/foreplay/#actions) Your own API key, 16 actions, Social media Ask your agent ``` 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. **“Find up to 10 currently running English-language video ads for warehouse automation and show their hooks and landing pages.”** uses `foreplay_search_ads` **“Find up to five Foreplay brands associated with the competitor domain I provide, with their brand and page IDs.”** uses `foreplay_brands_by_domain` **“Read this ad's creative, transcript and landing page, then summarize its message in five bullets.”** uses `foreplay_ad_details` ## Connect Foreplay in a minute One MCP for every integration. Add it once, then every MCP in the catalog is a request away. 1. 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. 2. 02 ### Add your Foreplay API key Paste it into the Foreplay [connection settings](https://app.flymy.ai/mcp-configs#foreplay) 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 ->](https://app.foreplay.co/) 3. 03 ### Ask Paste a request from this page. Every run shows what it cost. Claude Code ``` claude mcp add --transport http flymyai https://mcp-agents.flymy.ai/mcp ``` Then run /mcp in Claude Code and sign in. Codex ``` codex mcp add flymy --url https://mcp-agents.flymy.ai/mcp ``` Then run codex mcp login flymy to sign in. claude.ai and Claude Desktop ``` 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. [See usage pricing →](https://flymy.ai/pricing/) ## More Social media MCPs Publish to social networks and research creators, posts and ads. ### HikerAPI (Instagram) Public Instagram data of any account via HikerAPI: profiles, posts, reels, hashtags, comments, search 27 actions / no key Link: https://flymy.ai/mcp/instagram/ ### YoTrends YoTrends: trending YouTube and TikTok videos by region, the influencers that trend most, content categories with their trend weight, subcategories and... 5 actions / no key Link: https://flymy.ai/mcp/yotrends/ ### YouTube Publish videos, comments, channel analytics - your YouTube via one OAuth 9 actions / sign in Link: https://flymy.ai/mcp/youtube/ ### YouTube Public Data YouTube public data on the platform key: search, trending chart, statistics, channels, comments 10 actions / no key Link: https://flymy.ai/mcp/youtube-public/ ### Instagram Posts, Reels, DMs, comments, insights - your Instagram via one OAuth 12 actions / sign in Link: https://flymy.ai/mcp/instagram/ ### Ayrshare Ayrshare provides a Social Media API that enables developers to programmatically manage and automate social media posts, analytics, and interactions across... 4 actions / your API key Link: https://docs.flymy.ai/mcp/apps/ayrshare ## Go to the source [Foreplay in the docs →](https://docs.flymy.ai/mcp/foreplay), [Foreplay connection settings →](https://app.flymy.ai/mcp-configs#foreplay), [Every MCP in the catalog →](https://flymy.ai/mcp/#catalog), [Usage pricing →](https://flymy.ai/pricing/) 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. --- For agents: the FlyMyAI operating guide (sign up, connect, run models, tools and agents) is https://flymy.ai/skill.md, and https://flymy.ai/llms.txt lists the other pages and the documentation.