MCP server · 22,543+ real ads

The ad swipe file for AI agents

Your agent writes the ad. Give it real ones to learn from: 22,543+ Facebook and Instagram ads, filed by brand, niche and format, one prompt away.

Server URL (streamable HTTP, OAuth):

https://adswipefile.com/api/mcp

Free: 10 MCP/API calls a day and the first 100 ads of every list. No card.

Example: an AI assistant asks AdSwipeFile for recent ads over MCP and gets real ads back.

Your AI agent

adswipefile connected

Show me 3 recent ads from AdSwipeFile I can swipe for my launch.

adswipefile · list_ads · 3 results

Here are the 3 newest ads in the library, each linked to the full ad.

Pick your agent

Another client? Setup for every MCP client

How it works

  1. 1

    Add the server

    Add https://adswipefile.com/api/mcp with the steps above. Agents that run commands can do it themselves from the setup prompt.

  2. 2

    Sign in once

    Your agent opens AdSwipeFile in the browser. Sign in with a free account and approve read access. There is no API key.

  3. 3

    Ask in plain words

    Name a product, a niche, a format or a brand. Your agent searches the library and links every ad it cites.

Try these prompts

Using AdSwipeFile, find 5 recent Beauty / Personal Care ads in the Testimonial format. For each, give the brand, the hook and the link.
Search AdSwipeFile for meal kit ads and group them by angle: price, convenience or health. Link every ad.
List the ads I saved on AdSwipeFile and turn them into a one-page swipe file: the pattern each one uses, with its link.

On Free your agent reads each ad's brand, niche, format and a description of its visual. The ad's copy, and the hook in it, comes with Starter and Growth.

What your agent can do

  • Search the library search_library

    Keyword search across ads, brands, niches and formats. Matches whole words in each ad's copy and in a description of its visual (so "screenshot" or "before after" work); ads holding every word rank first. Returns each hit's type, slug or id, and page URL. Start here when you have a product, brand or idea rather than an exact slug.

  • List ads list_ads

    Newest ads first, optionally filtered by brand, niche and format slug. Paginate with the returned `nextCursor`.

  • Get an ad get_ad

    One ad in full: copy (on plans without ad copy, a line saying it is not included), audiences, brand, niche, formats, image URL and page URL.

  • List brands list_brands

    Every brand in the library, optionally only one niche's.

  • List niches list_niches

    Every niche (industry) ads are filed under.

  • List formats list_formats

    Every ad format (UGC, before/after, testimonial, …) ads are tagged with.

  • List my saved ads list_saved_ads

    The ads you saved on the site, newest first.

For AI agents

Setup steps written for the agent itself. Agents can also read llms.txt and skill.md.

If you are an AI agent setting up AdSwipeFile for your user:

1. Add the MCP server https://adswipefile.com/api/mcp (streamable HTTP, OAuth). Add it with your client's MCP setup (steps for each client: https://adswipefile.com/docs/mcp).
2. When the browser opens, ask your user to sign in with a free AdSwipeFile account and approve.
3. Check the connection: call list_niches.
4. For an idea or a product, start with search_library. For a niche, brand or format, use list_ads with its slug. Read one ad with get_ad.
5. Link each ad's page URL when you cite it. The library holds no performance data: never call an ad a winner.

FAQ

Which agents work with it?
Any client that connects to remote MCP servers with OAuth: Claude, ChatGPT, Claude Code, Cursor, Codex, Hermes, OpenClaw, Gemini CLI and others. Setup for each: https://adswipefile.com/docs/mcp.
My agent isn't listed. Can it still connect?
If it supports remote (streamable HTTP) MCP servers with OAuth sign-in, yes: give it https://adswipefile.com/api/mcp. There are no API keys, so an agent that cannot open a browser to sign in cannot connect yet.
Is it free?
Yes, to start. A free AdSwipeFile account includes the MCP server with 10 MCP/API calls a day and the first 100 ads of every list. Paid plans add every ad, its copy and more calls.
Can my agent change anything?
No. Every tool is read-only: it searches and reads the library and lists the ads you saved. It cannot post, buy or save on your behalf.
Where do the ads come from?
AdSwipeFile is a curated collection of 22,543+ real Facebook and Instagram ads, filed by brand, niche and format. It is not a live feed of Meta's Ad Library, and it holds no spend or performance data.

More