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.

  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: Get your Virlo API key

    Sign in to the Virlo developer dashboard, open API Keys and generate a key. It starts with virlo_tkn_.

  3. Step 3: Add Virlo to mcp.json

    Paste this into ~/.cursor/mcp.json to use Virlo in every project, or into .cursor/mcp.json for 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"
          }
        }
      }
    }
  4. 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.

  5. Step 5: Optional: add the Virlo skills

    This installs two skills into .agents/skills, which Cursor reads: virlo picks the right tool and ranks by Virality Score; short-form-trend-research turns trend data into a weekly content plan.

    Terminal
    npx skills add Virlo-AI/Virlo-Agent-Plugin
  6. Step 6: Ask the agent

    Open the agent panel and ask. Cursor asks before it runs a Virlo tool.

    Agent chat
    Pull 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?

RouteWhat you addSign-inBest for
Global config~/.cursor/mcp.json with the server URL and your keyAPI key headerUsing Virlo in every project
Project config.cursor/mcp.json in the repoAPI key header (keep the file out of git, or read the key from your environment)One project or one team
One-click buttonPaste your key on the Virlo MCP docs page, then click Install in CursorAPI keyThe fastest setup
Virlo skillsnpx skills add Virlo-AI/Virlo-Agent-PluginUses the server you addedBetter 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

What does Cursor get back from Virlo?
FieldValue
NameMy moon my man couple montage
StageFresh
Creators this week633
Creators last weeknew this week
Keep the sameThe song 'My Moon My Man' by Feist (often a specific remix or cover) and the theme of showing a romantic partner.
Make it yoursThe specific person or couple being shown and the setting of the clips.
Example videoExample video for the My moon my man couple montage trend@haleyybaylee

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 copy

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