AdSwipeFile

AdSwipeFile plugin

Winning Facebook and Instagram ads, competitor ads, hooks and angles, in Claude, ChatGPT and Codex: the AdSwipeFile ad library, searched by your AI agent.

AdSwipeFile files real Meta ads by brand, niche (industry) and format (UGC, before and after, testimonial, comparison…), each with its audiences and copy. This plugin connects your AI assistant to the library over MCP and adds skills that tell it how to research competitor ads, read hooks and angles, and cite every ad it uses.

What you can ask

• "What ads is Liquid Death running? Sum up its hooks and angles."
• "Show me winning UGC ads from skincare brands, with their hooks."
• "Find ads about protein powder."
• "Find testimonial ads for supplements and write 3 hooks for my product."
• "Compare the ads of my competitors and tell me which angles nobody runs."
• "Show me the ads I've saved and what they have in common."
• "What have the brands I follow launched this week?"

What is in here

The skills are plain Markdown instructions. The plugin ships no scripts, hooks or executables and installs no packages.

Install

ChatGPT: use the root plugin.json and mcp.json.

Claude Code

claude plugin marketplace add adswipefile/adswipefile-plugin

claude plugin install adswipefile@adswipefile

Codex: install from this repository; it reads .codex-plugin/plugin.json.

Any MCP client, without the skills

claude mcp add --transport http adswipefile https://adswipefile.com/api/mcp

On claude.ai or ChatGPT, add https://adswipefile.com/api/mcp as a custom connector. Setup for other clients: https://adswipefile.com/docs/mcp.

Sign-in and the data it sends

Connecting opens a browser sign-in to your AdSwipeFile account (OAuth 2.1). An AdSwipeFile account is required; there is no API key to copy. The plugin asks for read access to the ad library and to the ads you saved and the brands you follow on the site (mcp:read), and for permission to change your follows and boards (mcp:write). Most tools read. The write tools follow or unfollow a library brand, create or delete a board, turn a board's share link on or off, and put an ad on a board or take it off, only when you ask; they change nothing outside your account. A connection approved before the write tools reads only: reconnect and approve again to use them.

The plugin talks to one server, adswipefile.com. When the assistant calls a tool, the tool's arguments, such as a search query or a brand, niche or format, are sent to that server. AdSwipeFile records each tool call in its product analytics (PostHog): the tool name, its arguments (an argument containing an email address or a phone or card number is replaced first), timing, how the call turned out (how many results, or that nothing matched, the call was refused or it failed), errors, the AI client's name and version, and your account identifier. Calls made close together are grouped into a session (for ChatGPT, by the anonymous conversation id it sends). When you pick one of the server's ready-made prompts, it records which one, not what you typed into it. It does not record the rest of your conversation or the results it sends back, only how many, and nothing from your machine is sent. See the privacy policy.

Scope

AdSwipeFile is a reference library of ad creative. It holds no spend, reach or performance figures, cannot create, run or buy ads, and does not generate images or video. It is a curated collection, not a live feed of Meta's ad library.

Support

adswipefile.com/contact or hello@adswipefile.com. Report security issues as described in SECURITY.md.