Add a TikTok research MCP server to Zed

Updated

Virlo is social listening for TikTok and Instagram Reels. Zed's agent can read your whole codebase, yet it cannot see a single TikTok view count or Instagram trend on its own. Add Virlo under Settings, AI, MCP Servers and the agent can pull trends, hooks, sounds and outliers from a database of 23.1M viral videos while you write. Zed is a fast, open-source code editor with a built-in Agent Panel, support for external agents and MCP servers it calls context servers.

  • Add Remote Server from Settings, no extension needed
  • Standard MCP sign-in, or an Authorization header
  • Forwarded to external agents such as Claude Agent and Codex

Part of Virlo's AI assistant guides. Working in another editor? See VS Code or Cursor.

How do I add an MCP server to Zed?

Zed writes the server into your settings file for you. You need a recent Zed and a Virlo account.

  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: Open the MCP Servers settings

    In Zed, open Settings, then AI, then MCP Servers. Click Add Server in the page header and choose Add Remote Server.

  3. Step 3: Name the server and paste the URL

    Call it virlo and paste the Virlo endpoint. Zed saves it under context_servers in your settings file, which you can open any time with the zed: open settings file action.

    settings.json
    "context_servers": {
      "virlo": {
        "url": "https://dev.virlo.ai/api/mcp/mcp"
      }
    }
  4. Step 4: Authenticate and check the dot

    With no Authorization header set, Zed walks you through the standard MCP OAuth flow and opens the Virlo approval page. Back in MCP Servers, a green dot next to virlo with the tooltip "Server is active" means it is ready.

  5. Step 5: Ask in the Agent Panel

    Open the Agent Panel, start a new thread and ask. The agent can mix Virlo research with edits to the files you have open.

    Your first prompt
    Using Virlo, list this week's top TikTok trends to copy for [your niche] and add them to content/trends.md under a heading with today's date.

To skip the browser sign-in, add a headers object with "Authorization": "Bearer virlo_tkn_YOUR_KEY" to the virlo entry in context_servers.

Remote server vs header vs local bridge: which Zed setup should I use?

Setupcontext_servers entrySign-inBest for
Add Remote Server (OAuth)"virlo": { "url": "..." }Standard MCP OAuth in your browserMost people on their own laptop
Remote server with headerurl plus headers with Authorization: Bearer virlo_tkn_...API key, no browserMachines where you prefer a stored key
Add Local Server with mcp-remotecommand: "npx", args running mcp-remote with the URL and headerAPI key passed through the bridgeSetups standardised on local servers

Keys for the header and bridge routes are made on Virlo API Keys.

Zed Agent alone vs Zed Agent with Virlo

TaskWithout VirloWith Virlo
Draft a content calendar in MarkdownGeneric ideasBuilt from this week's trends to copy
Fill a demo app's fixturesInvented rowsReal TikTok and Instagram videos with links
Write a hook for a launch videoGuessworkHook types that reach a Virality Score of 18+

What is trending on TikTok right now, as Zed's agent sees it?

Live rows Zed's Agent Panel receives when it asks Virlo for trends to copy: each trend, its stage and how many creators posted it this week compared with last week.

In Virlo's tracking of 39 live trends to copy, "My moon my man couple montage" leads TikTok this week with 659 creators posting it as of November 19, 2026.

As of November 19, 2026 at 13:07 UTC

What is trending on TikTok right now, as Zed's agent sees it?
TrendStageCreators this weekCreators last week
Example video for the My moon my man couple montage trend by @haleyybayleeMy moon my man couple montageFresh659new this week
Example video for the While they're out partying btw trend by @larpniverseWhile they're out partying btwRising346115
Example video for the He wanna pay full price SNL trend trend by @anereslaila1He wanna pay full price SNL trendFresh175new this week
Example video for the But you're not a Buddhist trend trend by @nicolo.contradaBut you're not a Buddhist trendFresh15833
Example video for the Shoulder carry mirror selfie trend trend by @thecapcutterxShoulder 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, “Add a TikTok research MCP server to Zed”, virlo.ai/zed

Does Virlo work with external agents in Zed?

Zed runs external agents through the Agent Client Protocol, including Claude, Codex, OpenCode, Copilot, Cursor and Gemini CLI. Zed's own MCP servers may be forwarded to those agents over ACP, and each agent can also read its native MCP config.

If an external agent does not show Virlo's tools, add Virlo in that agent's own config as well. The Claude Code, Codex, OpenCode and Gemini CLI guides each have the exact command.

Zed Agent profiles only shape the built-in agent, so tool settings you choose there do not carry over to external agents unless the integration says so.

How marketers use Zed with Virlo

Zed is quick to open and light on memory, which makes it a comfortable place to keep scripts, briefs and content calendars as plain files. With Virlo behind the Agent Panel, the research lands right beside the writing:

  • Keep a content/ folder of Markdown briefs and let the agent refresh each one from this week's trends to copy.
  • Draft a script in one pane while the agent pulls the transcript of the TikTok you are modelling in the other.
  • Ask for hook types that win in your niche, then have the agent rewrite the opening line of the open file.
  • Replace placeholder data in a prototype with real Instagram Reels so a client demo looks finished.

Everything stays in ordinary files in your project, so the research is versioned with git alongside the work it informed.

What can I ask Zed's agent to research?

Try these in a new Agent Panel thread once the virlo dot is green. Fill in the brackets.

  • Trend notes

    Pull the trends to copy for [your niche] and append them to content/trends.md with the stage and creators this week for each.

  • Rising check

    Which TikTok trends in [your niche] gained the most creators since last week? Explain what changed in one line each.

  • Fixtures

    Replace the mock data in [file] with 20 real Instagram Reels about [topic], ranked by Virality Score, keeping the same fields.

  • Script from transcript

    Get the transcript of [TikTok link] and draft a script for [your product] in scripts/[name].md that follows the same structure.

  • Competitor notes

    Look up @[competitor] on TikTok and summarise their three biggest outliers and the hook each one used.

  • Sound list

    List five trending TikTok sounds this week that fit [your brand] and add them to the brief I have open.

  • Hook rewrite

    Find the hook types that win most often in [your niche] and rewrite the opening line in this file three ways using them.

  • Hashtag pass

    Which hashtags are growing around [topic] on TikTok this week? Add the top eight to the frontmatter of the brief I have open.

Zed Agent vs external agents vs other editors: which guide do I need?

Zed hosts more than one agent, and a security tool once shared the name.

Zed Agent (this page)

The built-in agent in Zed's Agent Panel. Virlo is added as a context server under Settings, AI, MCP Servers.

External agents in Zed

Claude, Codex, OpenCode and others running inside Zed over ACP. They may receive Zed's servers or use their own config.

VS Code

Microsoft's editor with its own MCP setup and Copilot agent, covered in a separate guide.

Zed Attack Proxy

The OWASP security scanner long known as ZAP. It is not related to the Zed editor.

What are the limits?

  • Virlo reads public TikTok and Instagram data only, so Zed's agent can research but never post or log in to social accounts.
  • The server lives in your Zed settings file under context_servers; delete the virlo entry there to remove it.
  • A dot that is not green in MCP Servers means the server is not running; hover it for the reason.
  • Trends to copy refresh hourly and pass a Virlo team check before they show up.
  • See pricing for Virlo plans.

Frequently asked questions

How do I add an MCP server to Zed?

Open Settings, then AI, then MCP Servers, click Add Server and choose Add Remote Server or Add Local Server. Zed writes the entry to your settings file under context_servers. For Virlo, a remote server named virlo with the endpoint URL is all you need.

Does Zed support remote MCP servers?

Yes. A remote entry in context_servers takes a url and optional headers, and Zed connects to it without any local process. When there is no Authorization header, Zed prompts you to authenticate with the standard MCP OAuth flow, which is how Virlo signs you in by default.

What are context servers in Zed?

Context servers is the name Zed's settings use for MCP servers. Each one gives the agent extra tools or data. Local ones use command, args and env; remote ones use url and headers, like the Virlo entry on this page.

Can Zed AI research TikTok?

With Virlo added, yes. The Agent Panel can ask for trends to copy, trending and breakout sounds, hook types, hashtags and outlier videos on TikTok and Instagram, then write the answers into the files you are working on. Each video comes back with its link and Virality Score.

How do I know the Virlo server is working in Zed?

Look at the indicator next to virlo in Settings, AI, MCP Servers. Green with the tooltip "Server is active" means it is running. Any other colour shows a tooltip explaining the problem, often a sign-in that has not been finished.

Can I use a Virlo API key in Zed?

Yes. Add a headers object to the virlo entry in context_servers with Authorization set to Bearer and your Virlo key, which begins with virlo_tkn_. Zed then sends the key on each request and skips the OAuth prompt. Keep that settings file out of shared dotfiles if it holds a key.

Do external agents in Zed get the Virlo server?

Zed may forward its MCP servers to external agents over ACP, and those agents may also read their own MCP config. If Claude or Codex inside Zed cannot see Virlo, add it in that agent's config too, using the Codex guide or Claude Code guide.

Can Zed post to TikTok with Virlo?

No. Virlo is read-only research on public TikTok and Instagram data and never touches social accounts. Zed's agent can use it to plan content, write scripts and build tools inside your project, but publishing videos stays outside Virlo and outside Zed.

Do I need mcp-remote to use Virlo in Zed?

No. Zed connects to remote servers directly through the url field in context_servers, so Virlo works without a bridge. The mcp-remote route only makes sense if you deliberately run every server as a local command; then use Add Local Server with npx, mcp-remote, the Virlo URL and your key header.

Research social media without leaving Zed

Add Virlo as a remote server and ask the Agent Panel what is working in your niche.