# Viral Swipe File

Searches viral TikToks and Instagram Reels by niche and format, giving an agent source material for hooks and content ideas.

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

## What it does

Viral Swipe File connects an agent to a library of short videos that performed well. Each entry can include its hook, caption, views, engagement, viral factor, and a watch link. The server supports niche research, creator video searches, format comparisons, hook writing, and briefs built from videos saved by a team.

It works through MCP and provides six Markdown skills for setup, post ideas, viral video research, hook writing, niche research, and saved-video briefs. The package contains no scripts, hooks, executables, or installed dependencies. The skills provide instructions; the remote server supplies the library.

Connection opens account sign-in through OAuth 2.1, so there is no API key to paste. Tools are read-only. This is an archive of past viral videos rather than a live trend feed, and its scope covers TikTok and Instagram Reels without analytics for your own account.

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

## Install

### Claude Code (native platform)

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

### Codex

**Platform CLI: remote server**
```bash
codex mcp add viral-swipe-file --url https://viralswipefile.com/api/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "viral-swipe-file": {
            "url": "https://viralswipefile.com/api/mcp"
        }
    }
}
```

### GitHub Copilot

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

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http viral-swipe-file https://viralswipefile.com/api/mcp
```

## When to use it
- find viral videos for a specific niche
- break down hooks and short-video formats
- draft hooks for a product or client
- turn saved team videos into a UGC brief

## Example prompts
- Find viral videos for a fitness client and extract the hook patterns.
- Compare TikTok formats that work for astrology, then suggest content ideas.
- Review our team’s saved videos and create a UGC brief.

## Similar
- [ad-swipe-file](https://affpapa.org/en/nevibecode/skills/ad-swipe-file.md) — skill · 20600 installs
- [viral-hook-creator](https://affpapa.org/en/nevibecode/skills/viral-hook-creator.md) — skill · 2500 installs
- [viral-hook](https://affpapa.org/en/nevibecode/skills/viral-hook.md) — skill · 1000 installs
- [discovering-viral-youtube-videos-by-category](https://affpapa.org/en/nevibecode/skills/discovering-viral-youtube-videos-by-category.md) — skill · 851 installs
- [viral-reverse-engineering](https://affpapa.org/en/nevibecode/skills/viral-reverse-engineering.md) — skill · 841 installs
- [discovering-viral-tiktok-content-trends](https://affpapa.org/en/nevibecode/skills/discovering-viral-tiktok-content-trends.md) — skill · 777 installs

---
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