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.
Step 1: Create your Virlo account for free
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_KEYso the Windsurf config can reference it instead of holding the raw value. Planning to sign in through the browser? You can skip this step.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}" } } } }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.
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 promptUse 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?
| Route | Where you add Virlo | How it signs in | Pick it when |
|---|---|---|---|
| Cascade's mcp_config.json | Open MCP config file in the Cascade MCP menu; paste a serverUrl entry | Browser sign-in, or Authorization header read from ${env:VIRLO_API_KEY} | You code in the Windsurf Editor every day |
| Windsurf Settings | Settings, then Tools, then Windsurf Settings, then + Add Server | Same as the file: OAuth or header | You prefer a form over editing JSON |
| Devin Desktop MCPs tab | Customize page in the Agents window, MCPs tab, scope set to This computer | Authenticate button when the server needs a login | Your install already updated to the Devin Desktop name |
| Devin CLI | devin mcp add virlo <server URL>, with -s user to share it across projects | OAuth on first use | You 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 git | Each teammate signs in with their own Virlo account | A 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 Cascade | Without Virlo | With Virlo connected |
|---|---|---|
| Seed a demo with real social posts | Placeholder JSON with invented captions | Real TikTok and Instagram videos with views, hooks and creator handles |
| What format should our launch video copy? | Advice it read on blogs | This 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-off | Sounds rising on TikTok and Instagram Reels over the last 7 days |
| Why did a competitor clip blow up? | A guess based on the caption | Its 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. My moon my man couple montage
Fresh · 659 creators this week

2. While they're out partying btw
Rising · 346 creators this week

3. He wanna pay full price SNL trend
Fresh · 175 creators this week

4. But you're not a Buddhist trend
Fresh · 158 creators this week

5. Shoulder carry mirror selfie trend
Fresh · 158 creators this week
| Trend | Stage | Creators this week | Creators last week |
|---|---|---|---|
| My moon my man couple montage | Fresh | 659 | new this week |
| While they're out partying btw | Rising | 346 | 115 |
| He wanna pay full price SNL trend | Fresh | 175 | new this week |
| But you're not a Buddhist trend | Fresh | 158 | 33 |
| Shoulder carry mirror selfie trend | Fresh | 158 | new 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 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 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.
More AI assistant guides
- AI assistant guides
- Claude
- Claude Code
- Cursor
- MCP server
- TikTok MCP server
- Instagram MCP server
- ChatGPT
- ChatGPT dots
- OpenAI Codex
- Gemini CLI
- Grok Build
- Claude Cowork
- n8n
- Zapier
- Grok Bot
- Muse
- Claude Duet
- Hermes Agent
- Kimi K3
- Cue
- Manus
- Perplexity Computer
- Paperclip
- OpenClaw
- NanoClaw
- DeepSeek
- AI agents CLI
- ChatGPT agent
- Perplexity
- Microsoft Copilot
- Le Chat
- Notion
- Slack
- Discord
- Telegram
- Google Sheets
- VS Code
- GitHub Copilot
- Cline
- JetBrains
- Kiro
- Google Antigravity
- goose
- Warp
- OpenCode
- Zed
- Amp
- Factory Droid
- Raycast
- Lovable
- Replit
- Bolt.new
- v0
- Ollama
- LM Studio
- Open WebUI
- LibreChat
- Make
- Pipedream
- Gumloop
- Lindy
- Relevance AI
- Airtable
- ClickUp
- Dify
- Flowise
- LangChain
- CrewAI
- OpenAI Agents SDK
- Mastra
- Vercel AI SDK
- Claude Agent SDK