Skip to content
VIRAL SWIPE FILE

TikTok MCP

TikTok hooks and content ideas from your AI agent

Past viral TikToks, ranked by viral factor (views against the account's usual), with the hook pulled out and the niche and format filed. Claude, ChatGPT, Grok and Cursor search them over MCP.

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.

Not TikTok's own library

Viral Swipe File is not affiliated with TikTok. It is a curated library of past viral TikToks, each with its hook, caption, creator, views and viral factor. Your agent reads it over MCP; you can browse the same videos on the site. Browse viral TikToks.

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 TikToks in the fitness niche and list each hook with its link.
Search Viral Swipe File for TikToks in the street interviews format and tell me how their first lines open: a question, a claim or a challenge. Link every video.
List the most viral TikToks in [your niche] on Viral Swipe File and sum up which formats they use most.

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). Add it with your client's MCP setup (steps for each client: https://viralswipefile.com/mcp).
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

Is this TikTok's own API?
No. Viral Swipe File is not affiliated with TikTok. It is a separate, curated library of viral TikToks, filed by niche and format, that your agent searches over MCP. It does not read your TikTok account or post for you.
Can my agent search only TikToks?
Yes. list_videos takes a platform filter, so ask for TikToks by name. The same library holds Instagram Reels too, so your agent can compare the two.
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