Skip to content

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, Cursor, Codex or any other MCP client (steps for each below), on Starter and Growth and their 7-day free trial, to find viral videos, read their stats (hooks and captions included), pull your team's saved videos into a conversation, and save videos, organize boards and follow creators from it. It changes nothing outside your workspace, and you sign in with your Viral Swipe File account.

1. Server URL

https://viralswipefile.com/api/mcp

2. Add it to your assistant

Example prompts and a page per client are in AI agents.

Claude

Add it from Claude's connector directory in one click. Or by hand:

  1. Open Customize → Connectors, click + Add and choose Add custom connector.
  2. Name it Viral Swipe File, paste the server URL, click Continue twice, then Add.
  3. Click Connect, sign in with your account and approve.

On Team and Enterprise plans an owner adds it first, in Organization settings → Connectors (Add → Custom → Web); members then click Connect.

Steps from Claude's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for Claude: example prompts and FAQ

Claude Cowork

Add it from Claude Cowork's connector directory in one click. Or by hand:

  1. Open Customize → Connectors, click + Add and choose Add custom connector.
  2. Name it Viral Swipe File, paste the server URL, click Continue twice, then Add.
  3. Click Connect, sign in with your account and approve.

Cowork uses the connectors of your Claude account: add Viral Swipe File once and it works in Claude, Cowork and Claude Desktop. On Team and Enterprise plans an owner adds it first, in Organization settings → Connectors (Add → Custom → Web); members then click Connect.

Steps from Claude's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for Claude Cowork: example prompts and FAQ

ChatGPT

Open ChatGPT's plugin directory:

  1. Click Install plugin.
  2. Sign in with your account and approve.
  3. In a chat, type @ and pick Viral Swipe File.

Steps from ChatGPT's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for ChatGPT: example prompts and FAQ

OpenAI dots

  1. Install Viral Swipe File in ChatGPT first, since dots share ChatGPT's plugins: open ChatGPT's plugin directory (https://chatgpt.com/plugins/plugin_asdk_app_6ad98ee067848191ba889e37db0c3684) and click Install plugin.
  2. In your dot's profile, open Customize → Plugins and turn on Viral Swipe File.
  3. Sign in with your account and approve when the dot first uses it.

dots are on ChatGPT Enterprise, Edu and Healthcare workspaces, where an admin has to allow plugins with MCPs.

Steps from OpenAI's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for OpenAI dots: example prompts and FAQ

Gemini

  1. On gemini.google.com, open Settings → Connected Apps and click Add a custom app.
  2. Paste the server URL and click Next.
  3. Sign in with your account and approve.

Google limits custom apps to personal Google accounts, 18 and over, in the US, in English, with Keep Activity on. Elsewhere, Antigravity connects from your computer.

Steps from Gemini's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for Gemini: example prompts and FAQ

Grok

  1. Open grok.com/connectors, click New Connector and choose Custom.
  2. Paste the server URL and add it.
  3. Sign in with your account and approve.

In Grok Bot, open Connect apps → Add a custom connector instead: name it Viral Swipe File, set Type to Remote HTTPS, paste the server URL and click Add plugin.

Steps from Grok's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for Grok: example prompts and FAQ

Perplexity Computer

  1. Open Customize → Connectors, click Add custom → Add MCP connector and choose Remote.
  2. Name it Viral Swipe File, paste the server URL and, under Advanced, choose OAuth and Streamable HTTP.
  3. Tick the acknowledgement, click Add, then click the card to sign in and approve.

In an organization, an admin has to turn on "Allow members to add custom connectors" first (it is off by default).

Steps from Perplexity's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for Perplexity Computer: example prompts and FAQ

Manus

  1. Open Settings → Integrations → Custom MCP Servers and click Add Server (in newer versions: Connectors → Create → MCP by URL).
  2. Name it Viral Swipe File and paste the server URL.
  3. Save, then sign in with your account if Manus opens a sign-in.

Manus's docs show custom servers signing in with an API key header, and confirm no OAuth sign-in. Viral Swipe File's MCP server signs in only through OAuth in a browser and takes no API key, so Manus cannot sign in to it yet.

Steps from Manus's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for Manus: example prompts and FAQ

Cue

  1. Where Cue links your services, add a custom MCP server.
  2. Name it Viral Swipe File and paste the server URL.
  3. Sign in with your account if Cue opens a sign-in.

Cue, Manus's invite-only personal agent, has not published MCP setup steps: these are the general ones, and Manus's own custom servers sign in with an API key. Viral Swipe File's MCP server signs in only through OAuth in a browser and takes no API key, so Cue may not be able to sign in yet.

Steps from Cue's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for Cue: example prompts and FAQ

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.

Steps from Claude Code's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for Claude Code: example prompts and FAQ

Codex

Run in your terminal:

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

Then run codex mcp login viralswipefile and sign in. Run /mcp in Codex to check the tools are there.

Steps from Codex's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for Codex: example prompts and FAQ

Antigravity

Add to ~/.gemini/config/mcp_config.json:

{
  "mcpServers": {
    "viralswipefile": {
      "serverUrl": "https://viralswipefile.com/api/mcp"
    }
  }
}

Then click Authenticate under Customizations → Installed → MCP Servers and sign in.

Steps from Antigravity's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for Antigravity: example prompts and FAQ

Gemini CLI

Run in your terminal:

gemini mcp add --transport http viralswipefile https://viralswipefile.com/api/mcp

Then run /mcp auth viralswipefile in Gemini CLI and sign in. Google replaced Gemini CLI with Antigravity CLI on June 18, 2026 for free and Google One accounts. On those, follow the Antigravity steps.

Steps from Gemini CLI's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for Gemini CLI: example prompts and FAQ

Grok Build

Run in your terminal:

grok mcp add --transport http viralswipefile https://viralswipefile.com/api/mcp

Then sign in in the browser Grok Build opens on first use. In its terminal UI, /mcps then i signs in again.

Steps from Grok Build's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for Grok Build: example prompts and FAQ

Devin

Run in your terminal (Devin CLI):

devin mcp add viralswipefile https://viralswipefile.com/api/mcp

Then run devin mcp login viralswipefile and sign in. In the Devin web app: Customize → MCPs → Add MCP → Add custom MCP, choose HTTP, paste the server URL, pick OAuth, save and click Connect.

Steps from Devin's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for Devin: example prompts and FAQ

Amp

Run in your terminal:

amp mcp add viralswipefile https://viralswipefile.com/api/mcp

Then start Amp again: it opens your browser to sign in.

Steps from Amp's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for Amp: example prompts and FAQ

Kimi Code

Run in your terminal:

kimi mcp add --transport http --auth oauth viralswipefile https://viralswipefile.com/api/mcp

Then run kimi mcp auth viralswipefile and sign in.

Steps from Kimi Code's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for Kimi Code: example prompts and FAQ

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.

Steps from opencode's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for opencode: example prompts and FAQ

Muse

Add to your Muse Code settings:

{
  "mcp_servers": {
    "viralswipefile": {
      "transport": "streamable_http",
      "url": "https://viralswipefile.com/api/mcp"
    }
  }
}

Then run muse mcp login viralswipefile and sign in. These steps are for Muse Code, Meta's coding agent. The Muse app builds its connectors itself and, as far as we could confirm, cannot add a server by URL.

Steps from Muse Code's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for Muse: example prompts and FAQ

DeepSeek

Add to the plugins of your DeepSeek Harness (dsh) profile, DeepSeek's open-source agent:

- id: mcp-viralswipefile
  name: '@deepseek-ai/dsh-mcp-client'
  config:
    serverName: viralswipefile
    transport: streamable-http
    url: https://viralswipefile.com/api/mcp

DeepSeek's chat app has no MCP support; DeepSeek Harness, in developer preview, has the plugin above. DeepSeek Harness's docs show custom servers signing in with an API key header, and confirm no OAuth sign-in. Viral Swipe File's MCP server signs in only through OAuth in a browser and takes no API key, so DeepSeek Harness cannot sign in to it yet.

Steps from DeepSeek Harness's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for DeepSeek: example prompts and FAQ

Cursor

Add to Cursor in one click. Or by hand:

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "viralswipefile": {
      "url": "https://viralswipefile.com/api/mcp"
    }
  }
}

Then sign in when Cursor prompts you.

Steps from Cursor's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for Cursor: example prompts and FAQ

VS Code

Run in your terminal:

code --add-mcp '{
  "name": "viralswipefile",
  "type": "http",
  "url": "https://viralswipefile.com/api/mcp"
}'

Then sign in when VS Code asks. Or run MCP: Add Server from the Command Palette, choose HTTP and paste the server URL. Copilot's agent mode can then use it.

Steps from VS Code's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for VS Code: example prompts and FAQ

Cline

Run in your terminal (Cline CLI):

cline mcp add viralswipefile https://viralswipefile.com/api/mcp --transport http

Then run cline mcp, choose Authorize OAuth and sign in. In the IDE extension: open MCP Servers → Remote Servers, enter the name and the server URL, choose Streamable HTTP and click Add Server. Cline's docs confirm the browser sign-in for its CLI. For the IDE extension they show remote servers with a key header only, and Viral Swipe File issues no API keys, so the extension may not sign in yet.

Steps from Cline's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for Cline: example prompts and FAQ

Goose

Add to ~/.config/goose/config.yaml:

extensions:
  viralswipefile:
    name: Viral Swipe File
    type: streamable_http
    uri: https://viralswipefile.com/api/mcp
    enabled: true

Then sign in when Goose opens your browser. Or run goose configure → Add Extension → Remote Extension (Streamable HTTP) and paste the server URL.

Steps from Goose's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for Goose: example prompts and FAQ

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 with the gateway stopped, and sign in. Stop the gateway with openclaw gateway stop before the login, and start it again after. Viral Swipe File's MCP server signs in only through OAuth in a browser and takes no API key, so run the login on a machine where a browser can open.

Steps from OpenClaw's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for OpenClaw: example prompts and FAQ

Hermes

Add to ~/.hermes/config.yaml:

mcp_servers:
  viralswipefile:
    url: https://viralswipefile.com/api/mcp
    auth: oauth

Then sign in in the browser Hermes opens on first connect. Or run hermes mcp login viralswipefile.

Steps from Hermes's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for Hermes: example prompts and FAQ

OpenBot

  1. An OpenBot admin adds a custom MCP server with the id viralswipefile, the title Viral Swipe File and the server URL (POST /api/plugins/servers/custom), then turns it on with Enable for this deployment.
  2. Each teammate opens /connections in OpenBot and clicks Connect next to Viral Swipe File.
  3. Sign in with your account in the tab that opens and approve.

OpenBot's docs don't yet say how a custom server signs in. Viral Swipe File's MCP server signs in only through OAuth in a browser and takes no API key, so if Connect asks for a key instead of opening a sign-in tab, OpenBot cannot connect yet.

Steps from OpenBot's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for OpenBot: example prompts and FAQ

Paperclip

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/mcp

Then run claude, type /mcp and sign in. Paperclip adds MCP servers per agent runtime, not in its own UI: an agent on another runtime takes that runtime's setup (see its page).

Steps from Paperclip's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for Paperclip: example prompts and FAQ

NanoClaw

Run for the group that should search the library:

ncl groups config add-mcp-server --id <group-id> --name viralswipefile --url https://viralswipefile.com/api/mcp

Then run ncl groups restart --id <group-id>. NanoClaw's docs document no OAuth sign-in for remote servers: secrets go through its OneCLI vault. Viral Swipe File's MCP server signs in only through OAuth in a browser and takes no API key, so NanoClaw may not be able to sign in to it yet.

Steps from NanoClaw's docs, checked Nov 2026. (opens in a new tab)

Viral Swipe File for NanoClaw: example prompts and FAQ

3. Try this prompt

Using Viral Swipe File, help me decide what to post for my fitness account. Find the 10 most viral videos in the fitness niche, group them by format, say what their hooks do, and link the best example of each. Then suggest 5 video ideas in those formats for my account: [describe your account and audience].

4. 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 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.