About AdSwipeFile
AdSwipeFile is an MCP-connected reference library for researching real Facebook and Instagram ad creative. It is for marketers and their AI assistants, with searchable ads, saved items, and brand follows; it provides no ad performance figures.
Key features
- 01Search ads by brand, niche, and format
- 02Review ad copy, audiences, hooks, and angles
- 03Compare competitor creative
- 04Review saved ads and followed brands
- 05Use five research and writing skills
Use cases
- 01Find UGC ads from brands in a chosen niche
- 02Compare competitor hooks and creative angles
- 03Draft product hooks informed by testimonial ads
- 04Review newly launched ads from followed brands
MCP support
The remote MCP server exposes the AdSwipeFile ad library to MCP clients. Its tools are read-only and require browser sign-in to an AdSwipeFile account using OAuth 2.1.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://adswipefile.com/api/mcpclaude mcp add --transport http com-adswipefile-adswipefile https://adswipefile.com/api/mcp{"mcpServers":{"com-adswipefile-adswipefile":{"type":"http","url":"https://adswipefile.com/api/mcp"}}}Open in Cursor{"servers":{"com-adswipefile-adswipefile":{"type":"http","url":"https://adswipefile.com/api/mcp"}}}Open in VS Code{"mcpServers":{"com-adswipefile-adswipefile":{"type":"http","url":"https://adswipefile.com/api/mcp"}}}{"mcpServers":{"com-adswipefile-adswipefile":{"serverUrl":"https://adswipefile.com/api/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMEAdSwipeFile 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 [email protected]. Report security issues as described in SECURITY.md.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.