AdSwipeFile
Winning Facebook and Instagram ads, competitor ads, hooks and angles for your AI agent. Read-only.
What can you do with AdSwipeFile?
- "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?"
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http adswipefile 'https://adswipefile.com/api/mcp'
{
"mcpServers": {
"adswipefile": {
"type": "http",
"url": "https://adswipefile.com/api/mcp"
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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.
Frequently asked questions
What is AdSwipeFile?
Winning Facebook and Instagram ads, competitor ads, hooks and angles for your AI agent. Read-only.
How do I install AdSwipeFile?
It runs as a remote server. In Claude Code: claude mcp add --transport http adswipefile 'https://adswipefile.com/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does AdSwipeFile need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is AdSwipeFile open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains AdSwipeFile?
It is published by adswipefile. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.