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
| Path | |
|---|---|
plugin.json, mcp.json |
The plugin in the Agent Plugins format, for ChatGPT, Codex and other clients |
.codex-plugin/plugin.json |
Codex manifest |
.claude-plugin/plugin.json |
Claude plugin manifest |
.claude-plugin/marketplace.json |
Marketplace entry, so this repo can be added as a Claude Code marketplace |
.cursor-plugin/, .grok-plugin/ |
Cursor and Grok manifests |
.mcp.json |
The remote MCP server, https://adswipefile.com/api/mcp |
skills/ |
Five skills: get started, find winning ads, competitor ads, write hooks from ads, review saved ads |
| assets/ | Icon and logo |
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. Every tool is read-only: it cannot change your account, your saved ads, your follows or your boards.
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, timing, errors, the AI
client's name and version, and your account identifier. 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, 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.