The social media MCP server for TikTok and Instagram

Updated

Virlo is social listening for TikTok and Instagram Reels. The Virlo MCP server lets Claude, Cursor, VS Code, OpenAI Codex and any other MCP client search a database of 23.1M viral videos and pull trends to copy, hooks, sounds, hashtags and creators. Add one URL, https://dev.virlo.ai/api/mcp/mcp, then sign in or send an API key.

  • One hosted server, nothing to install
  • Sign in with OAuth, or send a virlo_tkn_ API key
  • Listed in the official MCP Registry and the Claude directory

Part of Virlo's AI assistant guides. Want the platform detail? See the TikTok MCP server and the Instagram MCP server.

How do I add the Virlo MCP server to my AI app?

Every app uses the same server URL. Claude apps sign you in; most others take an API key from your Virlo dashboard, which starts with virlo_tkn_.

  1. Step 1: Create your Virlo account for free

    Create your free Virlo account in under a minute. Already signed up? Open API Keys.
  2. Step 2: Claude (claude.ai, Claude Desktop, Claude Cowork)

    Add "Virlo – social media brain" from the Claude directory, or open Settings, Connectors, Add custom connector and paste the URL. Sign in when asked. Full steps: the Claude guide.

    Server URL
    https://dev.virlo.ai/api/mcp/mcp
  3. Step 3: Claude Code

    Run this, then type /mcp to sign in. The Claude Code guide covers the plugin and skills.

    Terminal
    claude mcp add --transport http virlo https://dev.virlo.ai/api/mcp/mcp
  4. Step 4: Cursor

    Add this to ~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project), then restart Cursor. More in the Cursor guide.

    ~/.cursor/mcp.json
    {
      "mcpServers": {
        "virlo": {
          "url": "https://dev.virlo.ai/api/mcp/mcp",
          "headers": {
            "Authorization": "Bearer virlo_tkn_YOUR_KEY"
          }
        }
      }
    }
  5. Step 5: VS Code

    Add this to .vscode/mcp.json, then start the server from VS Code.

    .vscode/mcp.json
    {
      "servers": {
        "virlo": {
          "type": "http",
          "url": "https://dev.virlo.ai/api/mcp/mcp",
          "headers": {
            "Authorization": "Bearer virlo_tkn_YOUR_KEY"
          }
        }
      }
    }
  6. Step 6: Windsurf

    Windsurf runs Virlo through the mcp-remote bridge. Add this to ~/.codeium/windsurf/mcp_config.json.

    ~/.codeium/windsurf/mcp_config.json
    {
      "mcpServers": {
        "virlo": {
          "command": "npx",
          "args": [
            "-y", "mcp-remote",
            "https://dev.virlo.ai/api/mcp/mcp",
            "--header", "Authorization: Bearer virlo_tkn_YOUR_KEY"
          ]
        }
      }
    }
  7. Step 7: OpenAI Codex

    Codex uses the same bridge. Add this to ~/.codex/config.toml.

    ~/.codex/config.toml
    [mcp_servers.virlo]
    command = "npx"
    args = ["-y", "mcp-remote", "https://dev.virlo.ai/api/mcp/mcp", "--header", "Authorization: Bearer virlo_tkn_YOUR_KEY"]
  8. Step 8: Any other MCP client

    Use the server URL with Streamable HTTP. If the app supports MCP sign-in, sign in; if not, send the header Authorization: Bearer virlo_tkn_YOUR_KEY. Apps that only run local servers use the mcp-remote bridge above.

To check it worked, ask your app "Which Virlo tools can you use?" It should name tools such as get_content_trends and find_videos.

Which apps can use the Virlo MCP server?

AppHow to connectSign-inGuide
Claude (claude.ai, Desktop, Cowork)Claude directory connector, or a custom connector with the URLOAuth, no keyClaude guide
Claude Codeclaude mcp add, the Virlo plugin or the Virlo skillsOAuth via /mcp, or an API keyClaude Code guide
Cursor~/.cursor/mcp.json or the one-click button in the docsAPI keyCursor guide
VS Code (Copilot Chat).vscode/mcp.json with "type": "http"API keyConfig above
Windsurfmcp-remote bridge in mcp_config.jsonAPI keyConfig above
OpenAI Codexmcp-remote bridge in config.tomlAPI keyConfig above
Any MCP clientServer URL over Streamable HTTPOAuth or API keyMCP docs

Virlo is also in the official MCP Registry as io.github.arod90/virlo, pointing at the same URL.

What does the Virlo MCP server return?

One real answer per question, pulled from Virlo for this page. Ask the same question in your app and you get the full list.

In Virlo's data, 633 creators posted the "My moon my man couple montage" trend in the last 7 days, the top answer the trends tool gives as of November 18, 2026.

As of November 18, 2026 at 16:07 UTC

What does the Virlo MCP server return?
Question your app asksTool it callsTop answer
Which format are most creators copying?get_content_trendsMy moon my man couple montage: 633 creators this week
Which sound is trending on Instagram Reels?get_trending_sounds"Flower In A Hurricane (feat. Tame Impala, SZA, King Gizzard & the Lizard Wizard) [From GTAVI: Original Score]": 59 Reels in 7 days
Which hook type wins most often on TikTok?search_hooksPOV setup: 32.9% reach a Virality Score of 18+
Which hook type wins most often on Instagram?search_hooksComparison: 18.9% reach a Virality Score of 18+
What is the second trend to copy?get_content_trendsWhile they're out partying btw: 351 creators this week

Every answer, not just the top one

Connect the server and the same tools return the full lists, filters and history.

Start for free

How this sample is made

Source
Virlo's Trends to copy, Instagram sound rankings and daily hook snapshot: the same data the MCP tools read.
Window
Trends: creators in the last 7 days. Sounds: Reels in the last 7 days. Hooks: all hook-tagged videos in the latest snapshot. TikTok and Instagram only.
Method
Each row is the top item for that question, from the data the named tool reads.
As of
Trends November 18, 2026 at 16:07 UTC; sounds November 18, 2026 at 12:03 UTC; hooks November 18, 2026.
Made by
Numbers are pulled automatically from Virlo's data every hour; the text around them is written by the Virlo team.

Suggested citation: Source: Virlo, “The social media MCP server for TikTok and Instagram”, virlo.ai/mcp

Which tools does the Virlo MCP server have?

The tools fall into eight groups. Your app picks the right one from your question, so you never need the names; they are here for developers.

Virlo MCP tool groups
GroupWhat it answersTool names
SearchThe videos or creators on a topic that beat their usual reach the most, ranked by Virality Scorefind_videos, find_creators
TrendsThe formats creators are copying now, and the topics people are talking aboutget_content_trends, get_topic_trends
Sounds and hashtagsTrending and breakout sounds; hashtag reach and growthget_trending_sounds, lookup_sound, search_hashtags, lookup_hashtag
Hooks and writingOpening lines that work, which hook types win, and hooks or scripts shown with their source videossearch_hooks, show_hooks, show_script
Marketing agentsA one-off or always-on agent that researches a niche and reports backcreate_research_agent, get_agent_report, get_agent_data
LookupsA full creator profile, or why one video beat its creator's usual viewslookup_creator, analyze_video
TrackingA creator or video checked over timetrack_creator, track_video, get_tracking_data
Live readsWhat a platform shows right now: search, hashtag, video, comments, transcript or profileraw_search, raw_video, raw_comments, raw_transcript, raw_creator

What workflow prompts come with the server?

The server ships six ready-made research plans your app can run by name, for example "Use the trend_scout prompt for TikTok."

Virlo MCP workflow prompts
PromptWhat it does
startA first-run tour: learns your goal, drafts search phrases and asks before it runs anything
full_niche_analysisA full niche study: one research run, the top creators, then a weekly marketing agent
creator_deep_diveOne creator in depth, with the option to track them
trend_scoutA trend report from emerging topics, viral videos and hashtag momentum
genre_monitorA weekly agent on a TikTok genre or scene, plus a genre brief
competitor_landscapeThe real competitors around a creator or niche, and a positioning brief

What can I ask an AI app connected to Virlo?

These work in any MCP app. Replace the brackets.

  • New formats

    Which TikTok formats started in the last 7 days and are still rising?

  • Small creators

    Show the top 10 Instagram Reels about [topic] this month from creators under [N] followers.

  • Hook types

    Which hook types work best for [your niche]? Compare TikTok and Instagram.

  • Comments

    Read the comments on [video link] and tell me the questions viewers ask most.

  • Transcript

    Get the transcript of [TikTok link] and turn it into a script outline for [your product].

  • Hashtags

    Which hashtags grew fastest in [your niche] over the last 30 days?

  • Rising creators

    Who are 10 rising creators in [your niche] on Instagram? Give me their best video each.

  • Competitors

    Run the competitor_landscape prompt for [creator or niche].

MCP server vs API vs Claude connector: which one do I need?

Virlo reaches AI apps and code in a few ways. They share one database.

Virlo MCP server (this page)

For AI apps. Your assistant calls Virlo's tools from a plain-English question.

Claude directory connector

The same server, listed in Claude's directory so you can add it with one click.

Plugin and skills

Instructions that teach Claude Code and Cursor to use the server well: which tool to pick and how to rank results.

Virlo API

For code. REST endpoints at api.virlo.ai/v1 with an API key, for scripts, apps and pipelines.

What are the limits?

  • Public TikTok and Instagram Reels data only. The server never logs in to your social accounts and has no way to post.
  • Research agents and some lookups run in the background. Ask your app to check back; results are final when the job says finalized.
  • The server is stateless and answers POST only. Apps that only run local servers need the mcp-remote bridge.
  • If every tool says "Invalid or inactive API key", copy the key again from your dashboard. Setup only checks the virlo_tkn_ prefix.
  • Plans are on the pricing page.

Frequently asked questions

What is a social media MCP server?

A Model Context Protocol server that exposes social media data as tools an AI app can call. Virlo's is one: connect it to Claude, Cursor, VS Code or Codex and the assistant can look up TikTok and Instagram trends, viral videos, sounds, hashtags, hooks and creators from a plain-English question.

What is the Virlo MCP server URL?

https://dev.virlo.ai/api/mcp/mcp. It is the same for every user and every app, and it isn't a secret. Add it as a Streamable HTTP server or a custom connector, then sign in to Virlo when your app asks, or send your API key in an Authorization header.

Which AI apps can connect to the Virlo MCP server?

Claude (claude.ai, Claude Desktop, Claude Cowork), Claude Code, Cursor, VS Code with Copilot Chat, Windsurf, OpenAI Codex and any other client that supports remote MCP servers. The AI assistant guides page lists each one with how it connects and how sign-in works.

Is there a TikTok MCP server?

Yes. Virlo's MCP server returns public TikTok data to any MCP app: the formats creators are copying this week, trending and breakout sounds, hashtags, hooks, creator profiles and full video transcripts. The TikTok MCP server page lists every TikTok tool and shows a live sample.

Is there an Instagram MCP server for Claude?

Yes. The same Virlo server covers Instagram Reels: Reels search ranked by Virality Score, trending Reels sounds, Instagram hashtags, creator lookups and tracking. Add it to Claude from the Claude directory. Details and a live sample are on the Instagram MCP server page.

Do I need an API key for the Virlo MCP server?

Not in Claude, Claude Desktop, Claude Cowork or Claude Code: they sign you in with OAuth and Virlo makes a key for them. Cursor, VS Code, Windsurf and Codex usually need a key from your Virlo developer dashboard. Keys start with virlo_tkn_.

Can the Virlo MCP server post to social media?

No. It reads public TikTok and Instagram data and never logs in to your accounts. Use it to research what to make: trends, hooks, sounds and outlier videos. Post with your usual scheduler or the apps themselves, so your accounts stay fully under your control.

Is the Virlo MCP server the same as the Virlo API?

They share one database but serve different users. The MCP server is for AI apps: your assistant calls tools from plain language. The REST API at api.virlo.ai/v1 is for code: scripts, apps and pipelines that send an API key. Both are documented at dev.virlo.ai.

Is Virlo in the official MCP Registry?

Yes. Virlo is in the official MCP Registry as io.github.arod90/virlo, with the remote URL https://dev.virlo.ai/api/mcp/mcp over Streamable HTTP. Directories that copy from the registry pick up the same entry, and the Claude directory lists Virlo as "Virlo – social media brain".

Why don't the Virlo tools show up in my app?

Most apps load MCP servers at startup, so restart after you add Virlo. Check the URL has no trailing slash and, if you use a key, that it starts with virlo_tkn_. Apps that only run local servers need the mcp-remote bridge shown above.

Give your AI app a social media brain

Add one URL and ask what's going viral on TikTok and Instagram.