Viral Swipe File

npx add-mcp 'https://viralswipefile.com/api/mcp'

Connect your AI agent to Viral Swipe File

Ask your AI agent for hooks and content ideas, and it answers from real viral videos. Connect Viral Swipe File to Claude, ChatGPT, Grok, Claude Code, Cursor, Codex, Hermes, OpenClaw, Gemini CLI or any MCP client, free on every plan, to find viral videos, read their stats (hooks and captions included, on every plan), and pull your team's saved videos into a conversation.

• Server URL: https://viralswipefile.com/api/mcp
• Server name: viralswipefile
• Transport: streamable HTTP. Authorization: OAuth 2.1 with dynamic client registration; you sign in with your Viral Swipe File account. No API key.
• Access: Connecting an AI agent is free on every plan, hooks and captions included, and any account can use the JSON API. Free: 50 questions a day (MCP tool calls and API requests together), counted from midnight UTC. Starter and Growth: no daily cap on agent questions; JSON API requests (bulk pulls) are 10,000 requests a month on Starter and 50,000 requests on Growth, counted from the 1st of each month (UTC). Calls to list_niches and list_formats, and the starter prompts, are never counted. Past the allowance, a tool answers with a message saying when the count starts again, instead of results. Plans: https://viralswipefile.com/pricing.
• Rate limit: 120 tool calls a minute per account, apart from the allowance. Past it, HTTP 429 with a JSON-RPC error and Retry-After in seconds.
• Server card: https://viralswipefile.com/.well-known/mcp.json

Add it to your assistant

• Claude (https://viralswipefile.com/agents/claude): Open Settings → Connectors → Add custom connector. Name it Viral Swipe File, paste the server URL and click Add. Click Connect, sign in with your account and approve.
• ChatGPT (https://viralswipefile.com/agents/chatgpt): Open Settings → Apps & Connectors → Advanced settings and turn on Developer mode. Back in Apps & Connectors, click Create, paste the server URL and choose OAuth. Sign in with your account and approve.
• Grok (https://viralswipefile.com/agents/grok): Open grok.com → Settings → Connectors (grok.com/connectors) and click New connector → Custom. Name it Viral Swipe File, paste the server URL and save. Click Connect, sign in with your account and approve.
• Claude Code (https://viralswipefile.com/agents/claude-code): Run in your terminal: claude mcp add --transport http viralswipefile https://viralswipefile.com/api/mcp. Then run /mcp in Claude Code and sign in.
• Cursor (https://viralswipefile.com/agents/cursor): Add to ~/.cursor/mcp.json (or your client's MCP config): { "mcpServers": { "viralswipefile": { "url": "https://viralswipefile.com/api/mcp" } } }. Then sign in when Cursor prompts you.
• Codex (https://viralswipefile.com/agents/codex): Run in your terminal: codex mcp add viralswipefile --url https://viralswipefile.com/api/mcp. Then run codex mcp login viralswipefile, which opens your browser to sign in, and /mcp in Codex to check the tools are there.
• Hermes (https://viralswipefile.com/agents/hermes): Add to ~/.hermes/config.yaml: mcp_servers: { viralswipefile: { url: https://viralswipefile.com/api/mcp, auth: oauth } }. Then sign in in the browser window Hermes opens on first connect (or run hermes mcp login viralswipefile).
• OpenClaw (https://viralswipefile.com/agents/openclaw): Add to ~/.openclaw/openclaw.json, so every channel gets the tools: { "mcp": { "servers": { "viralswipefile": { "url": "https://viralswipefile.com/api/mcp", "transport": "streamable-http", "auth": "oauth" } } } }. Then run openclaw mcp login viralswipefile and sign in. Viral Swipe File signs in through OAuth in a browser and issues no API keys, so run the login where a browser can open.
• Gemini CLI: Add to ~/.gemini/settings.json: { "mcpServers": { "viralswipefile": { "httpUrl": "https://viralswipefile.com/api/mcp" } } }. Then run /mcp auth viralswipefile in Gemini CLI and sign in.

Example prompts and a page per client: https://viralswipefile.com/agents.

Make it your agent's default

Paste this once so your agent keeps sending viral-video and hook questions to Viral Swipe File:

Save this as a note to follow in future chats: when I ask what to post, for content ideas, viral hooks or UGC hooks, which formats work in a niche, or about viral TikToks, Instagram Reels or a swipe file, use the Viral Swipe File connector (MCP server https://viralswipefile.com/api/mcp) before answering from memory. Find examples ranked by viral factor, read their hooks with get_video, and always link each video's Viral Swipe File page.

Tools

• search_library (Search the library): Search the curated viral video library (hooks, viral factor, niches, formats): keyword search across niches, formats, creator accounts and videos. Matches whole words in each video's hook, caption and a description of what it shows (so "morning routine" or "laptop" work); videos holding every word rank first. Returns each hit's type, slug or id, and page URL. Start here when you have a topic or creator rather than an exact slug.
• list_videos (List viral videos): Viral Instagram Reels and TikToks with their hooks, ranked by viral factor (views relative to the account's usual), views or recency. Filter by niche, format, platform, creator, content type, creator gender, time period, minimum viral factor or free text. Paginate with offset.
• get_video (Get a video): One video in full: hook, description, stats (views, viral factor, engagement), niche, formats, creator and links to the original and its page.
• list_niches (List niches): Every niche videos are filed under, with how many videos each has.
• list_formats (List formats): Every video format (selfie with background, story slideshow, street interviews, …) with how many videos each has.
• list_saved_videos (List my saved videos): The videos your team saved to its boards on the site.

Starter prompts

Ready-made prompts the server offers (in Claude, open a chat's + menu and pick Viral Swipe File):

• what-to-post (What to post next): Five post ideas for a client or account in one niche, each built on the format and hook of a real viral video, with links.
• viral-videos-in-my-niche (Viral hooks in my niche): The most viral videos in a niche, optionally in one format, with their hooks and the patterns they share.
• swipe-a-creator (Swipe a creator's best videos): One creator's most viral videos: the hooks and formats they reuse, with links.
• hooks-for-my-product (Hooks for my product or client): New hooks for your product, client or account, each written from a real viral video in the library.
• map-a-niche (Formats that work in a niche): Which formats lead in a niche, by how many of its most viral videos use each, with the best example of each.