MCP server for Codex

AdSwipeFile for Codex

Pull real ads into briefs, research files and copy, right from your terminal. 22,543+ real Facebook and Instagram ads, searchable from Codex.

Run in your terminal:

codex mcp add adswipefile --url https://adswipefile.com/api/mcp

Then run codex mcp login adswipefile and sign in.

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.

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

Search AdSwipeFile for supplement ads in the before/after format and save research/ads.csv with brand, niche, format and URL.
Using AdSwipeFile, list 20 recent Fashion ads and summarise the formats they use, with counts, in research/fashion.md.
Read the ads I saved on AdSwipeFile and write a short creative brief for each in briefs/.

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).
   Run in your terminal:
     codex mcp add adswipefile --url https://adswipefile.com/api/mcp
   Then run codex mcp login adswipefile and sign in.
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

How do I add AdSwipeFile to Codex?
Run in your terminal: `codex mcp add adswipefile --url https://adswipefile.com/api/mcp`. Then run codex mcp login adswipefile and sign in. Or paste the setup prompt into Codex and it adds the server itself.
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