Use Cursor to research TikTok and Instagram
Updated
Virlo is social listening for TikTok and Instagram Reels. Cursor's agent can't see what's trending on social media on its own. Add Virlo's MCP server to Cursor and the agent can pull TikTok and Instagram trends, hooks, sounds and outlier videos from a database of 23.1M viral videos, right next to your code, with whichever model you pick.
- One entry in mcp.json, nothing to install
- Virlo skills that teach the agent to rank by Virality Score
- Works with Claude, GPT, Gemini or any model in Cursor
Part of Virlo's AI assistant guides. Working in the terminal? See Claude Code. Every other app is on the Virlo MCP server page.
How do I connect Virlo to Cursor?
Five minutes, no install. You need a Virlo account and an API key.
Step 1: Create your Virlo account for free
Step 2: Get your Virlo API key
Sign in to the Virlo developer dashboard, open API Keys and generate a key. It starts with virlo_tkn_.
Step 3: Add Virlo to mcp.json
Paste this into
~/.cursor/mcp.jsonto use Virlo in every project, or into.cursor/mcp.jsonfor one project. Shortcut: paste your key on the Virlo MCP docs page and it makes a one-click Cursor install button.~/.cursor/mcp.json{ "mcpServers": { "virlo": { "url": "https://dev.virlo.ai/api/mcp/mcp", "headers": { "Authorization": "Bearer virlo_tkn_YOUR_KEY" } } } }Step 4: Restart Cursor and check the tools
Open Cursor's MCP settings and confirm virlo is on, with its tools listed. If Cursor offers to sign you in to Virlo, you can leave the header out and sign in instead.
Step 5: Optional: add the Virlo skills
This installs two skills into
.agents/skills, which Cursor reads:virlopicks the right tool and ranks by Virality Score;short-form-trend-researchturns trend data into a weekly content plan.Terminalnpx skills add Virlo-AI/Virlo-Agent-PluginStep 6: Ask the agent
Open the agent panel and ask. Cursor asks before it runs a Virlo tool.
Agent chatPull this week's top 10 TikTok trends to copy from Virlo and save them to data/trends.json with name, stage and creators this week.
Which install route should I pick?
| Route | What you add | Sign-in | Best for |
|---|---|---|---|
| Global config | ~/.cursor/mcp.json with the server URL and your key | API key header | Using Virlo in every project |
| Project config | .cursor/mcp.json in the repo | API key header (keep the file out of git, or read the key from your environment) | One project or one team |
| One-click button | Paste your key on the Virlo MCP docs page, then click Install in Cursor | API key | The fastest setup |
| Virlo skills | npx skills add Virlo-AI/Virlo-Agent-Plugin | Uses the server you added | Better tool choices and rankings from the agent |
What does Cursor get back from Virlo?
One real Trends to copy record, this week's #1 trend, laid out the way the agent receives it from get_content_trends. Ask for it as JSON and the agent can drop it straight into your app.
In Virlo's data this week, "My moon my man couple montage" is the trend to copy with the most creators: 633 in the last 7 days, as of November 18, 2026.
As of November 18, 2026 at 16:07 UTC
| Field | Value |
|---|---|
| Name | My moon my man couple montage |
| Stage | Fresh |
| Creators this week | 633 |
| Creators last week | new this week |
| Keep the same | The song 'My Moon My Man' by Feist (often a specific remix or cover) and the theme of showing a romantic partner. |
| Make it yours | The specific person or couple being shown and the setting of the clips. |
| Example video |
38 more trends to copy
The full list, with history and every example, is in the Virlo app and over the MCP server.
Open Trends to copyHow this sample is made
- Source
- Virlo's Trends to copy: formats found by Virlo's trend detector and published only after the team checks each one.
- Window
- Creators who posted each trend in the last 7 days, counted from TikTok and Instagram videos only. Trends made with an AI tool are left out.
- Method
- Ranked by creators posting this week. Stages: Fresh, Rising, Peaking, Fading.
- As of
- November 18, 2026 at 16:07 UTC. Refreshes every hour.
- 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, “Use Cursor to research TikTok and Instagram”, virlo.ai/cursor
How does Cursor use Virlo?
Cursor's agent treats Virlo like any other MCP tool. It reads each tool's description, picks one for your question and shows you the call before it runs.
- Research while you build: pull live trend, sound or hook data into JSON, CSV or Markdown in your repo.
- Prototype with real data: build a dashboard, a content calendar or a brief generator on top of actual TikTok and Instagram results.
- Keep context in the editor: the agent can read your product docs and match them to videos that worked.
- Switch models freely: Virlo returns the same data whichever model you pick.
What can I ask Cursor to do with Virlo?
Paste these into the agent panel. Replace the brackets.
Seed a dataset
Pull the top 25 Instagram Reels about [topic] from the last 30 days with Virlo and save them to data/reels.json.
Build a view
Build a React table from data/trends.json with columns for name, stage and creators this week, sorted by creators.
Hook data
Which hook types reach a Virality Score of 18+ most often on TikTok? Write the answer to docs/hooks.md as a table.
Creator file
Look up @[handle] on TikTok with Virlo and save their 10 best videos to data/creator.json.
Sound check
List the five sounds trending on Instagram Reels this week and add them to content/sounds.md.
Transcript
Get the transcript of [TikTok link] and turn it into a script template in templates/script.md.
Match the product
Read README.md, then find 10 TikTok videos that match what this product does and explain why each one worked.
Cursor vs Claude Code vs VS Code: which guide do I need?
All three are coding tools that can use Virlo. Only the config file changes.
Cursor (this page)
The AI code editor from Anysphere. Add Virlo to mcp.json and ask the agent.
Claude Code
Anthropic's terminal agent. Add Virlo with one claude mcp add command or the Virlo plugin.
VS Code
Microsoft's editor with Copilot Chat. Add Virlo to .vscode/mcp.json with "type": "http"; the config is on the MCP server page.
What are the limits?
- Public TikTok and Instagram data only. Virlo has no access to your own social accounts and never posts.
- Keep your API key out of git. Use the global config, or a project file that is in .gitignore.
- Cursor loads MCP servers at startup, so restart after you change mcp.json.
- The server URL must have no trailing slash.
- Plans are on the pricing page.
Frequently asked questions
How do I add an MCP server to Cursor for TikTok data?
Add Virlo to ~/.cursor/mcp.json under "mcpServers", with "url": "https://dev.virlo.ai/api/mcp/mcp" and an Authorization header holding your Virlo API key. Restart Cursor, check that virlo shows its tools in the MCP settings, then ask the agent a TikTok question.
Is there a Cursor MCP for TikTok and Instagram data?
Yes. Virlo's MCP server works in Cursor and returns public TikTok and Instagram Reels data: trends to copy, viral videos ranked by Virality Score, sounds, hashtags, hooks, creators and TikTok transcripts. The same server works in Claude and Claude Code, so one setup covers every app you use.
Do I need an API key to use Virlo in Cursor?
Usually, yes. Generate one in the Virlo developer dashboard; it starts with virlo_tkn_ and goes in the Authorization header of mcp.json. If your Cursor version offers to sign you in to Virlo when it connects, you can skip the header and sign in instead.
Can Cursor's agent use Virlo with any model?
Yes. The Virlo server returns the same data whichever model you pick in Cursor, whether that is Claude, GPT, Gemini or another one. Models differ in how they phrase the answer, not in what Virlo sends back, so the numbers stay the same.
Where do I put the Virlo config in Cursor?
Use ~/.cursor/mcp.json to make Virlo available in every project, or .cursor/mcp.json in a repo for one project. If you commit the project file, read the key from your environment rather than writing it in, so it never lands in git history.
Cursor doesn't show the Virlo tools. What should I check?
Check that mcp.json is valid JSON, the URL has no trailing slash and the key starts with virlo_tkn_. Then restart Cursor, because servers load at startup. If tools appear but every call says "Invalid or inactive API key", copy the key again from your dashboard.
Can Cursor post to TikTok or Instagram through Virlo?
No. Virlo is read-only: it reads public TikTok and Instagram videos and never logs in to your accounts. Cursor's agent can research, rank and explain videos with it, and you post with your usual tools.
Does Virlo work in VS Code too?
Yes. VS Code with Copilot Chat takes the same server in .vscode/mcp.json with "type": "http", the URL and your key header. Windsurf and OpenAI Codex connect through the mcp-remote bridge. Every config is on the Virlo MCP server page.
Is Cursor the same as Claude Code?
No. Cursor is an AI code editor made by Anysphere, and Claude Code is Anthropic's terminal agent. Both can use Virlo through the same server; Claude Code adds it with one command or a plugin. See the Claude Code guide for that route.
Bring social media data into your editor
Add one entry to mcp.json and ask Cursor what is going viral on TikTok and Instagram.