Windsurf MCP setup: give Cascade live TikTok and Instagram data

Updated

Virlo is social listening for TikTok and Instagram Reels. Cascade, the agent inside the Windsurf IDE, can refactor a codebase in minutes, yet it has no idea which TikTok or Instagram videos are taking off this week. Put Virlo in Windsurf's mcp_config.json and Cascade can pull trends, hooks, sounds and outlier videos from a database of 23.1M viral videos. Windsurf is Cognition's AI code editor, now shipped as Devin Desktop.

  • One serverUrl entry in Cascade's MCP config
  • Sign in to Virlo in the browser, or read your key from an environment variable
  • The same server works in Devin Desktop and the Devin CLI

Part of Virlo's AI assistant guides. Comparing AI editors? See Cursor and VS Code.

How do I add the Virlo MCP server to Windsurf?

Cascade reads remote servers from one JSON file. Add Virlo there, refresh, and the agent can call Virlo's research tools in any chat.

  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: Copy a key and store it as VIRLO_API_KEY

    Generate a key on the Virlo API Keys page; it begins with virlo_tkn_. Save it in your shell profile as VIRLO_API_KEY so the Windsurf config can reference it instead of holding the raw value. Planning to sign in through the browser? You can skip this step.

  3. Step 3: Open Cascade's MCP config file

    In the Cascade panel, open the MCP menu and choose Open MCP config file. You can also go to Settings, then Tools, then Windsurf Settings and click + Add Server. Paste the block below under mcpServers. Cascade expands ${env:VIRLO_API_KEY} from your environment when it loads the file.

    mcp_config.json
    {
      "mcpServers": {
        "virlo": {
          "serverUrl": "https://dev.virlo.ai/api/mcp/mcp",
          "headers": {
            "Authorization": "Bearer ${env:VIRLO_API_KEY}"
          }
        }
      }
    }
  4. Step 4: Refresh, or sign in instead of using a key

    Press the refresh button in Cascade's MCP list and virlo should show its tools. Cascade supports OAuth on Streamable HTTP servers, so you may delete the headers block entirely: on the next refresh Windsurf opens Virlo's sign-in page, you approve, and no key ever touches the file.

  5. Step 5: Ask Cascade a research question

    Open a new Cascade chat in your project and describe the output you want. Cascade shows each Virlo call before it runs it.

    Your first prompt
    Use Virlo to find this week's top 10 TikTok trends to copy in [your niche] and write them to research/trends.md with the part to keep, the part to change and one example video each.

On Devin Desktop builds, the same server can be added from the Customize page in the Agents window (MCPs tab), or from a terminal with devin mcp add virlo followed by the server URL.

Cascade config vs Devin Desktop MCPs tab vs Devin CLI: which Windsurf route fits?

RouteWhere you add VirloHow it signs inPick it when
Cascade's mcp_config.jsonOpen MCP config file in the Cascade MCP menu; paste a serverUrl entryBrowser sign-in, or Authorization header read from ${env:VIRLO_API_KEY}You code in the Windsurf Editor every day
Windsurf SettingsSettings, then Tools, then Windsurf Settings, then + Add ServerSame as the file: OAuth or headerYou prefer a form over editing JSON
Devin Desktop MCPs tabCustomize page in the Agents window, MCPs tab, scope set to This computerAuthenticate button when the server needs a loginYour install already updated to the Devin Desktop name
Devin CLIdevin mcp add virlo <server URL>, with -s user to share it across projectsOAuth on first useYou run Devin agents from a terminal or script
Project file.devin/mcp_config.json committed to the repo, or .devin/mcp_config.local.json kept out of gitEach teammate signs in with their own Virlo accountA whole team should get Virlo when they open the repo

Every route talks to the same Virlo server, so a trend list pulled in the editor matches one pulled from the CLI.

Cascade on its own vs Cascade with Virlo

You ask CascadeWithout VirloWith Virlo connected
Seed a demo with real social postsPlaceholder JSON with invented captionsReal TikTok and Instagram videos with views, hooks and creator handles
What format should our launch video copy?Advice it read on blogsThis week's trends to copy, each with the part to keep and the part to make yours
Which sound fits a 15-second product demo?Song names from its training cut-offSounds rising on TikTok and Instagram Reels over the last 7 days
Why did a competitor clip blow up?A guess based on the captionIts spoken hook, on-screen text, format and Virality Score against the creator's usual views

What can Cascade pull from Virlo for a Windsurf project?

These are live Trends to copy cards, the same records Cascade receives when it calls Virlo. Ask it to save them as JSON and they can feed a component, a seed script or a weekly brief.

In Virlo's data, 659 creators posted "My moon my man couple montage" in the last 7 days, the most of any trend to copy as of November 19, 2026.

As of November 19, 2026 at 13:07 UTC

  1. Example video for the My moon my man couple montage trend by @haleyybaylee

    1. My moon my man couple montage

    Fresh · 659 creators this week

  2. Example video for the While they're out partying btw trend by @larpniverse

    2. While they're out partying btw

    Rising · 346 creators this week

  3. Example video for the He wanna pay full price SNL trend trend by @anereslaila1

    3. He wanna pay full price SNL trend

    Fresh · 175 creators this week

  4. Example video for the But you're not a Buddhist trend trend by @nicolo.contrada

    4. But you're not a Buddhist trend

    Fresh · 158 creators this week

  5. Example video for the Shoulder carry mirror selfie trend trend by @thecapcutterx

    5. Shoulder carry mirror selfie trend

    Fresh · 158 creators this week

What can Cascade pull from Virlo for a Windsurf project?
TrendStageCreators this weekCreators last week
My moon my man couple montageFresh659new this week
While they're out partying btwRising346115
He wanna pay full price SNL trendFresh175new this week
But you're not a Buddhist trendFresh15833
Shoulder carry mirror selfie trendFresh158new this week

See all 39 trends to copy

Recipes, 30-day charts, client fit and every example video are in the Virlo app.

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 19, 2026 at 13: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, “Windsurf MCP setup: give Cascade live TikTok and Instagram data”, virlo.ai/windsurf

A weekly Windsurf workflow for marketers who also ship code

Plenty of small teams keep their landing pages, scripts and content calendar in one repo. With Virlo inside Cascade, research lands in that same repo as files the whole team can diff, review and reuse.

  • Monday: ask Cascade for this week's trends to copy in your niche and save them to research/trends.md.
  • Have it pull the hooks behind the five strongest outlier videos and add them to research/hooks.md.
  • Ask for three scripts that keep each trend's structure but swap in your product, written to scripts/.
  • Check rising sounds on TikTok and Instagram Reels and attach one to each script.
  • Commit the folder, so next Monday Cascade can compare fresh data with last week's files.

Virality Score measures how far a video beat its creator's typical views; 18 or more is strong. Asking Cascade to sort by it surfaces small accounts with a repeatable idea, not just famous ones.

Does the Windsurf to Devin Desktop rename change the setup?

Cognition renamed Windsurf to Devin Desktop in June 2026, and windsurf.com now forwards to the Devin site. Cascade-era configs still load: the editor reads ~/.codeium/windsurf/mcp_config.json, while the file opened from Cascade's menu lives at ~/.config/devin/mcp_config.json on macOS and Linux or %AppData%/devin/mcp_config.json on Windows.

Whichever build you run, the Virlo entry is identical: a server URL plus either a sign-in or an Authorization header. Devin's newer config format also accepts a plain url key, so the block above keeps working after an update.

Rolling Virlo out to a Windsurf team

A shared repo is the easiest place to standardise. Commit .devin/mcp_config.json with the virlo entry and no headers block, and every developer who opens the project gets Virlo in Cascade, then signs in with their own account the first time a tool runs.

Personal tweaks belong in .devin/mcp_config.local.json, which stays out of git. That file is the right home for anyone who wants to use an API key from their environment instead of the browser sign-in, without changing what the rest of the team sees.

Enterprise admins who curate an MCP registry can add Virlo's URL there once, so it shows up under Available on each machine's MCPs tab with an Install button.

What should I ask Cascade once Virlo is connected?

Paste any of these into a Cascade chat. Replace each bracket with your own detail.

  • Trend file

    Pull the 15 biggest TikTok trends to copy in [your niche] this week and save them to data/trends.json with stage and creators this week.

  • Seed real data

    Replace the mock posts in [file path] with 20 real Instagram Reels about [topic] from Virlo, keeping the same JSON shape.

  • Hook bank

    Collect 25 spoken hooks from TikTok videos about [topic] with a Virality Score of 18 or more and group them by hook type in docs/hooks.md.

  • Competitor teardown

    Look up @[competitor] on TikTok, list their videos that beat their usual views, and explain what those videos share.

  • Script draft

    Get the transcript of [TikTok link] and write a 30-second script for [your product] that follows the same beats, saved to scripts/draft.md.

  • Sound shortlist

    Which sounds are breaking out on Instagram Reels this week? Pick three that suit a [tone] video for [your brand].

  • Creator list

    Find 10 creators under [N] followers in [your niche] whose recent videos keep outperforming their follower count, and write them to data/creators.csv.

  • Product match

    Read README.md, then use Virlo to find 10 TikTok videos that sell a problem like ours and summarise why each one worked.

Windsurf vs Devin Desktop vs Cursor: which guide fits my editor?

Several AI editors grew out of VS Code, and Windsurf itself now carries a new name. They all reach the same Virlo server.

Windsurf / Devin Desktop (this page)

Cognition's agentic IDE. Cascade, and now Devin Local, read MCP servers from mcp_config.json or the MCPs tab.

Windsurf plugins

Extensions that bring the same agent into JetBrains IDEs and VS Code. They use the Cascade MCP settings described above.

Cursor

Anysphere's AI code editor. It takes Virlo through ~/.cursor/mcp.json with a url key rather than serverUrl.

VS Code

Microsoft's editor, where Copilot's agent reads Virlo from .vscode/mcp.json under a servers key.

What are the limits?

  • Virlo only reads public TikTok and Instagram data. Cascade can research and write files with it but cannot post to, comment on or log in to any social account.
  • Cascade picks up config edits after you press refresh in its MCP list; a malformed JSON file stops every server in it from loading.
  • On team and enterprise plans, an admin can limit servers to an approved MCP registry under Team settings, MCP & ACP, so ask them to allow Virlo there.
  • Trends to copy refresh every hour, and the Virlo team checks each one before it is listed.
  • For what each Virlo plan includes, see pricing.

Frequently asked questions

How do I add an MCP server to Windsurf?

Open Cascade's MCP menu, choose Open MCP config file and add an entry under mcpServers. For Virlo that entry is "serverUrl": "https://dev.virlo.ai/api/mcp/mcp", plus an Authorization header or nothing else if you prefer to sign in. Press refresh and Cascade lists Virlo's research tools.

Where is the Windsurf mcp_config.json file?

The editor reads ~/.codeium/windsurf/mcp_config.json (windsurf-next for the Next build). The file opened from Cascade's menu sits at ~/.config/devin/mcp_config.json on macOS and Linux and %AppData%/devin/mcp_config.json on Windows. Opening it through the menu avoids guessing which one your build uses. Both files take the same mcpServers block, so the Virlo entry never needs rewriting.

Does Windsurf support remote MCP servers?

Yes. Cascade connects to Streamable HTTP and SSE servers by URL using the serverUrl key, and it supports OAuth for both. Virlo runs on Streamable HTTP with OAuth, so no local bridge or npx command is needed; the URL alone is enough to start the sign-in.

Can Windsurf see TikTok and Instagram videos?

Not without help. With Virlo connected, Cascade gets what a video contains in text form: the spoken hook, on-screen text, format, view counts, Virality Score and, for TikTok, the transcript. That is enough to explain why a clip worked or build a script on its structure.

Is Windsurf now called Devin Desktop?

Yes. Cognition, which acquired Windsurf, renamed the editor Devin Desktop in June 2026, and its local agent became Devin Local alongside Cascade. The Virlo setup carries over: the same server URL works in the Cascade config, the MCPs tab on the Customize page and the Devin CLI.

How do I keep my Virlo key out of the Windsurf config?

Use environment interpolation. Store the key as VIRLO_API_KEY and write "Authorization": "Bearer ${env:VIRLO_API_KEY}" in the headers block; Cascade fills it in when the file loads. Or drop the header and sign in through the browser, which keeps credentials out of every file.

Virlo does not appear in Cascade. What should I check?

Confirm the JSON parses, the key is serverUrl with no trailing slash after /mcp, and the environment variable is set in the shell that launched Windsurf. Then hit refresh in the MCP list. If an admin enforces an MCP registry, Virlo has to be on the allowed list first.

Can Cascade post to TikTok through Virlo?

No. Virlo is a research layer: it reads public TikTok and Instagram data and never connects to anyone's accounts. Cascade can rank videos, draft scripts and build dashboards on top of it, and publishing stays with whatever scheduler or app you already use.

Is Windsurf the same as Cursor?

No. Both started from VS Code, but Windsurf is built by Cognition and Cursor by Anysphere, and their MCP files differ: Windsurf expects serverUrl, Cursor expects url. The Cursor guide walks through that editor's mcp.json. Teams that use both editors can point them at the same Virlo account.

Give Cascade a social media brain

Paste one serverUrl into Windsurf and ask what is working in your niche on TikTok and Instagram this week.