MCP server for Paperclip
Viral Swipe File for Paperclip
Paperclip can search viral TikToks and Reels once Viral Swipe File is connected, and report on them in every channel it runs.
For agents on the Claude Code adapter, run as the OS user Paperclip's heartbeat runs as:
claude mcp add --transport http --scope user viralswipefile https://viralswipefile.com/api/mcpThen run claude, type /mcp and sign in.
7-day free trial. Cancel anytime.
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.
How Paperclip connects
1
Run one command
It adds Viral Swipe File's MCP server to Paperclip. Or paste the setup prompt and Paperclip runs it itself.
2
Sign in once
Paperclip opens Viral Swipe File in your browser. Sign in with your account and approve access; your team needs Starter, Growth or the free trial.
3
Ask in plain words
Give Paperclip a research task: it searches the library and reports back in your channel, with links.
Prompts to try
As our content agent, use Viral Swipe File to find the 10 most viral videos in [your niche] and file a brief for the video team with hook, format and link.Research [your competitor's app] on Viral Swipe File and report its top hooks, formats and creators to the CMO agent.Pick the 3 formats with the most viral fitness videos on Viral Swipe File and assign one script per format to the writer agent.Make it Paperclip's default
Save this preference for future chats: when I ask for examples from Viral Swipe File, use its connected catalog (MCP server https://viralswipefile.com/api/mcp). Retrieve examples relevant to my request, distinguish stored video hooks from new writing, and include source links. The library is an archive, not a live trend feed. Do not apply this preference to requests for other sources or tasks outside the catalog.What Paperclip can do
Search the library
search_library
Search the stored Viral Swipe File catalog by topic, creator or category name. Returns matching videos, creators, niches and formats with IDs, slugs, descriptions and page URLs; video hits have no stats. Accepts plain keywords, not Boolean operators. May expand a word prefix or correct spelling, disclosed in hint or corrected_query. Preview access caps results. No pagination or live platform search.
List viral videos
list_videos
Retrieve stored TikToks and Instagram Reels by the supplied filters, ordered by viral factor, views or recency. Returns hooks, descriptions, stats, classification labels where available, and source links. Classification filters match classified videos only. Preview access caps results; next_offset is null at the available end. Missing creators return found: false and possible matches. followed: true lists only the creators and brands the workspace follows, with every filter. Six cards by default. Does not fetch new posts or measure live trends.
Get a video
get_video
Retrieve one stored video by its UUID for close analysis: full hook and description, available stats, creator, niche, formats, classification labels and links. how_its_built describes its construction, not the cause of its performance; it may be null and is omitted with preview access. Does not return a video download or full transcript. Unknown IDs return an error.
List niches
list_niches
Retrieve the catalog's available niches, names, slugs, video counts and page URLs, for browsing or resolving a niche filter. Takes no input and does not count against the team's tool-call allowance. Covers this catalog only, not every topic on TikTok or Instagram.
List formats
list_formats
Retrieve the catalog's available library formats, names, slugs, video counts and page URLs, for browsing or resolving a format filter. These differ from classification visual_format labels. Takes no input and does not count against the team's tool-call allowance.
List brands
list_brands
Retrieve published apps and brands promoted in the catalog's videos, ordered by video count, with slugs, creator and video counts, top viral factor and links. Publication requires verified source, sufficient coverage and an acceptable name. Preview access caps this list; it has no search or pagination input. Absence from a result does not establish why a brand is missing or whether it runs paid campaigns.
Get a brand
get_brand
Retrieve a published brand by slug or matching name: stored video and creator counts, views, viral factors, top hooks, creators and links. Includes its niche, format and classification mix when access permits; preview access omits mix. Unknown or unpublished brands return an error. These are catalog aggregates, not the brand's account analytics or proof of paid sponsorship.
List my saved videos
list_saved_videos
Retrieve a workspace's saved library videos and their shared notes, newest save first, for a requested review or brief. Returns video cards, note (null when absent), next_offset and the workspace read.
workspacetakes an id or exact name from list_workspaces; without it, the current workspace. Preview access caps results; no saves returns an empty list. Cannot read another organization's saves. To change saves and notes, use save_video, unsave_video and set_video_note.List new videos from creators I follow
list_followed_videos
Retrieve the newest library videos from the creators a workspace follows, newest to join the library first, with the followed creators. Returns video cards, next_offset, the creators (handle, platform, app page URL) and the workspace read.
workspaceas in list_saved_videos. Empty when the workspace follows nobody; the result then says where following is set up. Preview access caps results. Covers creators in this library only, not a live feed of their accounts.List my boards
list_boards
Retrieve a workspace's boards, A to Z: each with its id, name, how many videos it holds, its app URL and its
share_urlwhen its public share link is on (null when off). Use the ids or exact names with the board tools in the same workspace. Takes an optionalworkspace. Does not count against the team's tool-call allowance.List my workspaces
list_workspaces
Retrieve the organization's workspaces, oldest first: each with its
id,name,current(true for the one calls act in without aworkspaceargument) andlocked(past the plan's workspaces: it cannot be read or changed). Saves, notes, boards and follows belong to one workspace; pass its id or exact name asworkspaceto the tools that take one. Does not count against the team's tool-call allowance.Switch workspace
switch_workspace
Make a workspace of the organization (its id or exact name, from list_workspaces) the one this connection works in: every later call without
workspacereads and writes there, until the next switch. Only this connection moves; the user's workspace on the site, and their other assistants', stay where they are. Returns theworkspacenow active and thepreviousone. A workspace the caller may not use (another organization's, a guest's, one past the plan's workspaces) is refused, and nothing moves. Switch only when the user asks to work on another client or brand. Does not count against the allowance.Check my remaining calls
get_usage
Retrieve the team's MCP and API calls this period:
used,limit,left,per(day,month, orlifefor an account with no plan, whose preview calls never reset),resets_at(when the count starts again, UTC; null when it never does) andexhausted; on a monthly plan,todayholds the daily ceiling, andleftandexhaustedfollow whichever limit runs out first. MCP tool calls and JSON API requests share this allowance. A team whose calls are not counted answerslimit: null. Read-only and does not count against the allowance. Call it before a long run of reads, or when the user asks how many calls are left.Inspect a saved video
get_saved_video
Read one video's save state in the specified workspace, or the current one: saved, the workspace note, and every board containing it with that board's note and whether its link is public (shared). Use before replacing a note, removing a board item or unsaving, to show what would be lost and identify public changes. Accepts a video id or page URL. Returns saved: false and an empty boards list when absent. Read-only, unmetered and available without a paid plan; workspace access rules still apply. Does not return the video's catalog details.
Save a video
save_video
Save an existing library video in the specified
workspace, or the current one when omitted, when the user asks to save it.video_idtakes the video id from list_videos, search_library or get_video, or its Viral Swipe File page URL. Returns the video id and URL,saved: true, the saved videos page URL and the workspace. The save is visible to everyone in that workspace and appears in list_saved_videos. Saving a saved video changes nothing and keeps its note. Needs a trial or a plan; otherwise nothing is saved and the answer says so. Does not add the video to a board, download it, or change the original post.Unsave a video
unsave_video
Unsave a video in the workspace: it leaves list_saved_videos and every board it was on, and its notes go with it. Read get_saved_video first and confirm with the user when it is on a board or has a note, explaining which notes and board entries will be removed. A video that is not saved succeeds and changes nothing. Open on every plan.
Write a note on a saved video
set_video_note
Write the workspace's note on a saved video (why it is worth keeping, what to borrow), or with
boardthat board's own note on it. Replaces the note there, and the old text is not kept; an empty note clears it. Read get_saved_video first; show the existing note and confirm before replacing it. A board-specific note is public when that board is shared: explain this and confirm before publishing new text. The video must be saved, or on the board, first (save_video, add_video_to_board). get_saved_video returns workspace and board-specific notes; list_saved_videos returns only the workspace note. Open on every plan.Create a board
create_board
Create a board with
namein the specifiedworkspace, or the current one when omitted, when the user asks for one. Board names are unique in a workspace: a name that exists returns that board withcreated: false. Optionalvideo_id(a library video id or its page URL) also saves that video and puts it on the board. Returns the board id, name, video count, app URL,share_url(null for a new board; an existing board keeps its link) and the workspace. A new board is visible to the workspace only. If the name already exists, optional video_id adds to that existing board; when it is shared, the added video becomes public. With video_id, check list_boards first and confirm that public addition before calling. Needs a trial or a plan; otherwise nothing is created and the answer says so.Rename a board
rename_board
Rename one of the workspace's boards (by id or exact name from list_boards) with
name. Its videos, notes and share link stay as they are. A name another board of the workspace has is refused. Open on every plan.Delete a board
delete_board
Delete one of the workspace's boards, by id or exact name. Its videos stay saved (list_saved_videos), its board notes go, and its share link stops working. Cannot be undone: confirm with the user first. A board that is not there answers
found: false. Open on every plan.Share a board by link
share_board
Turn on a board's public share link and return it as
share_url: anyone with the link sees the board, its videos and all board-specific notes without an account. Workspace save notes stay private. Explain this exposure and confirm with the user before sharing. A board already shared returns its current link unchanged. Needs a trial or a plan.Turn off a board's share link
unshare_board
Turn off a board's share link: the old link stops working at once, and sharing it again later makes a new link. A board whose link is already off succeeds and changes nothing. Open on every plan; an owner or admin of the organization can also turn off a link in a locked workspace (name it as
workspace).Add a video to a board
add_video_to_board
Put a library video on an existing board in the specified
workspace, or the current one when omitted, when the user asks.boardtakes an id or exact name from list_boards;video_ida library video id or its page URL. Also saves the video in that workspace. Returns the board, the video,on_board: trueand the workspace. Check list_boards first: if the share link is on, anyone with the link sees the added video; explain this and confirm the public addition. Adding a video already on the board changes nothing. Needs a trial or a plan.Remove a video from a board
remove_video_from_board
Take a video off one of the workspace's boards; it stays saved, but its board-specific note is deleted. Read get_saved_video first and confirm any note loss. If shared, the public board also loses the item. A video that is not on the board succeeds and changes nothing. Open on every plan.
Follow a creator
follow_creator
Follow a library creator in the workspace, as the Follow button on their page does: their new library videos then show in list_followed_videos and on the app's Track page.
creatortakes their TikTok or Instagram handle (with or without @);platformpicks one when the handle is on both. Only creators with videos in the library can be followed. Following a creator already followed succeeds and changes nothing. Returns how many creators the organization follows and how many its plan allows, across its workspaces. When the plan follows nobody, or the organization is at its cap, nothing is followed and the answer says so: relay it once, do not retry.Stop following a creator
unfollow_creator
Stop following a creator in the workspace: their videos leave list_followed_videos and the Track page. Open on every plan. Unfollowing a creator the workspace does not follow succeeds and changes nothing.
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 in Paperclip with the steps on this page.
2. When the browser opens, ask your user to sign in with their Viral Swipe File account and approve. Their team needs Starter, Growth or the 7-day free trial.
3. Check the connection: call list_niches.
4. For a topic or a creator, start with search_library, in 2 to 4 plain words (no OR or quotes). For a niche or a format, take its slug from list_niches or list_formats (not counted) and call list_videos, sorted by viral factor. Lists already carry each hook; use get_video only for a video worth a close read.
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 Paperclip?
Can Paperclip search TikTok and Instagram Reels?
Is it free?
Can my agent change anything?
Where do the videos come from?
What is the viral factor?
Other MCP servers for viral videos
Viral Swipe File is one of several MCP servers for finding viral short-form videos. These tools list an MCP server on their own sites, checked on 24 October 2026: pick one to see its alternatives and how it compares.