# AdSwipeFile

Connects an AI agent to a Meta ad library for competitor research, hook analysis, and angle discovery. The connection is read-only.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: adswipefile
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/adswipefile/adswipefile-plugin
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/adswipefile

## What it does

AdSwipeFile gives an AI agent access to Facebook and Instagram ad research through a remote MCP server. It can search by brand, niche, or ad format, inspect hooks and creative angles, compare competitors, and draft new hooks from ads it finds. The package includes five Markdown skills covering onboarding, ad discovery, competitor research, hook writing, and saved-ad reviews.

You need an AdSwipeFile account to sign in through an OAuth 2.1 browser flow; there is no API token to paste. The repository contains manifests and Markdown instructions, with no scripts, hooks, executables, or package installation. Every operation is read-only, so the server cannot edit your account or run campaigns. Its library has no spend, reach, or performance metrics, and it is a curated collection rather than a live Meta feed.

## Requirements
- Remote server: `https://adswipefile.com/api/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http adswipefile https://adswipefile.com/api/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add adswipefile --url https://adswipefile.com/api/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "adswipefile": {
            "url": "https://adswipefile.com/api/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "adswipefile": {
            "type": "http",
            "url": "https://adswipefile.com/api/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http adswipefile https://adswipefile.com/api/mcp
```

## When to use it
- find a competitor’s ads by brand
- break down hooks and creative angles
- locate UGC or testimonial ads by niche
- compare the angles used by competitors
- draft product hooks from selected ads

## Example prompts
- Find Liquid Death’s ads and compare their hooks and creative angles.
- Show me UGC ads from skincare brands and list the hooks they use.
- Compare my competitors’ ads and suggest angles they have not used.

## Similar
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 107701
- [openshorts](https://affpapa.org/en/nevibecode/mcp/openshorts.md) — MCP server · ★ 7132
- [OpenScreen](https://affpapa.org/en/nevibecode/mcp/openscreen.md) — MCP server · ★ 4963
- [Usertour MCP Server](https://affpapa.org/en/nevibecode/mcp/usertour-mcp-server.md) — MCP server · ★ 2329
- [Appllama](https://affpapa.org/en/nevibecode/mcp/appllama.md) — MCP server · ★ 3228
- [obsei](https://affpapa.org/en/nevibecode/mcp/obsei.md) — MCP server · ★ 1441

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md