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_.
Step 1: Create your Virlo account for free
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 URLhttps://dev.virlo.ai/api/mcp/mcpStep 3: Claude Code
Run this, then type
/mcpto sign in. The Claude Code guide covers the plugin and skills.Terminalclaude mcp add --transport http virlo https://dev.virlo.ai/api/mcp/mcpStep 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" } } } }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" } } } }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" ] } } }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"]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?
| App | How to connect | Sign-in | Guide |
|---|---|---|---|
| Claude (claude.ai, Desktop, Cowork) | Claude directory connector, or a custom connector with the URL | OAuth, no key | Claude guide |
| Claude Code | claude mcp add, the Virlo plugin or the Virlo skills | OAuth via /mcp, or an API key | Claude Code guide |
| Cursor | ~/.cursor/mcp.json or the one-click button in the docs | API key | Cursor guide |
| VS Code (Copilot Chat) | .vscode/mcp.json with "type": "http" | API key | Config above |
| Windsurf | mcp-remote bridge in mcp_config.json | API key | Config above |
| OpenAI Codex | mcp-remote bridge in config.toml | API key | Config above |
| Any MCP client | Server URL over Streamable HTTP | OAuth or API key | MCP 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
| Question your app asks | Tool it calls | Top answer |
|---|---|---|
| Which format are most creators copying? | get_content_trends | My 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_hooks | POV setup: 32.9% reach a Virality Score of 18+ |
| Which hook type wins most often on Instagram? | search_hooks | Comparison: 18.9% reach a Virality Score of 18+ |
| What is the second trend to copy? | get_content_trends | While 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 freeHow 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.
| Group | What it answers | Tool names |
|---|---|---|
| Search | The videos or creators on a topic that beat their usual reach the most, ranked by Virality Score | find_videos, find_creators |
| Trends | The formats creators are copying now, and the topics people are talking about | get_content_trends, get_topic_trends |
| Sounds and hashtags | Trending and breakout sounds; hashtag reach and growth | get_trending_sounds, lookup_sound, search_hashtags, lookup_hashtag |
| Hooks and writing | Opening lines that work, which hook types win, and hooks or scripts shown with their source videos | search_hooks, show_hooks, show_script |
| Marketing agents | A one-off or always-on agent that researches a niche and reports back | create_research_agent, get_agent_report, get_agent_data |
| Lookups | A full creator profile, or why one video beat its creator's usual views | lookup_creator, analyze_video |
| Tracking | A creator or video checked over time | track_creator, track_video, get_tracking_data |
| Live reads | What a platform shows right now: search, hashtag, video, comments, transcript or profile | raw_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."
| Prompt | What it does |
|---|---|
start | A first-run tour: learns your goal, drafts search phrases and asks before it runs anything |
full_niche_analysis | A full niche study: one research run, the top creators, then a weekly marketing agent |
creator_deep_dive | One creator in depth, with the option to track them |
trend_scout | A trend report from emerging topics, viral videos and hashtag momentum |
genre_monitor | A weekly agent on a TikTok genre or scene, plus a genre brief |
competitor_landscape | The 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.