Skip to content

MCP server for opencode

Viral Swipe File for opencode

opencode can search viral TikToks and Reels once Viral Swipe File is connected, and pull their hooks into briefs, scripts and research files.

Run in your project:

opencode mcp add viralswipefile --url https://viralswipefile.com/api/mcp

Then run opencode mcp auth viralswipefile 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.

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

    Run one command

    It adds Viral Swipe File's MCP server to opencode. Or paste the setup prompt and opencode runs it itself.

  2. 2

    Sign in once

    opencode 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. 3

    Ask in plain words

    Give opencode a task that needs viral videos: it writes their hooks into briefs, scripts or research files, with links.

Prompts to try

Once it's connected, paste one into opencode.
Using Viral Swipe File, list the 10 most viral TikToks in [your niche] and add them to content/swipe.md as a table with hook, format and link.
Search Viral Swipe File for "[your topic]" videos and write a checklist of the hook patterns they share, citing each video.
Look up the creator [handle] on Viral Swipe File and summarise their most viral videos in research/creators/[handle].md.

Make it opencode's default

Paste this once so opencode keeps sending viral-video and hook questions to Viral Swipe File.
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 opencode 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. workspace takes 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. workspace as 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_url when 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 optional workspace. 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 a workspace argument) and locked (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 as workspace to 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 workspace reads 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 the workspace now active and the previous one. 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, or life for an account with no plan, whose preview calls never reset), resets_at (when the count starts again, UTC; null when it never does) and exhausted; on a monthly plan, today holds the daily ceiling, and left and exhausted follow whichever limit runs out first. MCP tool calls and JSON API requests share this allowance. A team whose calls are not counted answers limit: 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_id takes 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 board that 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 name in the specified workspace, 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 with created: false. Optional video_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. board takes an id or exact name from list_boards; video_id a library video id or its page URL. Also saves the video in that workspace. Returns the board, the video, on_board: true and 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. creator takes their TikTok or Instagram handle (with or without @); platform picks 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.

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 in opencode 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 opencode?

Run in your project: opencode mcp add viralswipefile --url https://viralswipefile.com/api/mcp. Then run opencode mcp auth viralswipefile and sign in. Add --global to the first command to use it in every project. Or paste the setup prompt into opencode and it adds the server itself. Steps from opencode's docs, checked Nov 2026.

Can opencode search TikTok and Instagram Reels?

Yes, once Viral Swipe File is connected: opencode searches Viral Swipe File's curated library of past viral TikToks and Instagram Reels by keyword, niche, format or platform, and reads each hook, its views and its viral factor. It does not browse TikTok or Instagram live.

Is it free?

It starts with a 7-day free trial of Starter or Growth: card required, nothing charged before day 8, once per team. The MCP server and the JSON API come with every plan, hooks and captions included, and count against one allowance: MCP tool calls and API requests together. During the trial: 200 calls a day, counted from midnight UTC. Starter: 10,000 calls a month, up to 1,000 a day. Growth: 50,000 a month, up to 3,000 a day. Months count from the 1st (UTC). An account without a plan gets a preview over MCP: 20 calls in all, each list cut to its first 4 results, and no API. Plans: https://viralswipefile.com/pricing.

Can my agent change anything?

Only your workspace, and only when you ask: it can save videos, write notes on them, make, rename, share and delete boards, and follow creators, once you approve that permission when you connect. Everything else reads: it searches the library and reads videos. It cannot post, buy or change your plan.

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 20x 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.

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.

Other agents