Skip to content
VIRAL SWIPE FILE

MCP server for Grok

Viral Swipe File for Grok

Ask for hooks and content ideas in the chat and get real viral videos back, each with its link. Research hooks right inside Grok, where you already write: viral TikToks and Instagram Reels, ranked by viral factor.

  1. Open grok.com → Settings → Connectors (grok.com/connectors) and click New connector → Custom.
  2. Name it Viral Swipe File, paste the server URL and save.
  3. Click Connect, sign in with your account and approve.

Server URL (streamable HTTP, OAuth):

https://viralswipefile.com/api/mcp

Free: 50 agent questions a day, hooks and captions included. No card.

Your AI agent

viralswipefile connected

Find the most viral fitness videos on Viral Swipe File and give me their hooks.

list_videos · niche: fitness · sort: viral

The most viral fitness videos, ranked by viral factor. For each one: its hook, format, viral factor and a link to its page.

Illustration. Real answers quote videos from the library, each linked to its page.

How it works

  1. 1

    Add the server

    Add the server with the setup above. Agents that run commands or edit their own config can add it themselves from the setup prompt.

  2. 2

    Sign in once

    Your agent opens Viral Swipe File in the browser. Sign in with your account (free is enough) and approve read access. There is no API key.

  3. 3

    Ask in plain words

    Name a niche, a format, a creator or a client's topic, or ask what to post tomorrow. Your agent finds viral videos ranked by viral factor, reads their hooks and links every video it cites.

Try these prompts

Using Viral Swipe File, find the 10 most viral videos in the fitness niche and group their hooks by format, so I know what to post tomorrow. Link each video.
Search Viral Swipe File for "morning routine" videos and tell me which hooks open with a question. Link every video.
List the videos my team saved on Viral Swipe File and write five new hooks in their style for my client: [describe the client].

Make it your agent's default

Once connected, 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.

What your agent can do

  • Search the library search_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 viral videos list_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 a video get_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 my saved videos list_saved_videos

    The videos your team saved to its boards on the site.

For AI agents

Setup steps written for the agent itself. Agents can also read llms.txt and skill.md.

If you are an AI agent setting up Viral Swipe File for your user:

1. Add the MCP server https://viralswipefile.com/api/mcp (streamable HTTP, OAuth; server name viralswipefile). Ask your user to add it: 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.
2. When the browser opens, ask your user to sign in with their Viral Swipe File account (free is enough) and approve.
3. Check the connection: call list_niches.
4. For a topic or a creator, start with search_library. For a niche or a format, call list_videos with its slug, sorted by viral factor. Read a video's full hook with get_video.
5. Link each video's Viral Swipe File page when you cite it. The library holds past viral videos, not live trends.

FAQ

How do I add Viral Swipe File to 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. The server URL is https://viralswipefile.com/api/mcp.
Is it free?
Yes, to start. 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). Plans: https://viralswipefile.com/pricing.
Can my agent change anything?
No. Every tool is read-only: it searches the library, reads videos and lists your team's saved videos. It cannot post, save or buy anything.
Where do the videos come from?
Viral Swipe File is a curated library of past viral TikToks and Instagram Reels, each filed under a niche and one or more formats, with its hook, caption, creator, views and viral factor. It is not a live feed of this week's trends, and it does not read your own account's analytics.
What is the viral factor?
How many times more views a video got than its account usually gets. A video at x20 did twenty times its creator's normal numbers, so it is worth studying whatever the size of the account: the idea travelled on its own, not on a big following.

More