tavily-mcp MCP server in Zed context servers, Zed style.
Zed calls MCP servers "context servers" and configures them in its main settings.json — no separate MCP file. Here's the context_servers block that connects tavily-mcp (2.1k stars) to Zed's Agent Panel.
Zed's MCP integration lives directly in ~/.config/zed/settings.json under a key named context_servers — Zed's term for MCP servers. There's no dedicated MCP config file and the JSON shape differs slightly from other clients, so configs copied from Cursor or Claude Desktop guides need adjusting.
tavily-mcp gives Zed's Agent Panel web search through the Tavily API. You'll need Node.js installed (Zed spawns the server with npx) and an API key from tavily.com.
Open Zed's settings
Run the zed: open settings command from the command palette (Cmd+Shift+P on macOS), which opens ~/.config/zed/settings.json. Zed validates settings as you type, so you'll see inline errors for malformed JSON before they bite.
Zed also has an extensions ecosystem that wraps some MCP servers as one-click installs — worth a glance in the extension panel — but the manual context_servers route below works for any server, tavily-mcp included.
Add the context_servers block
Note the shape: the command is an object with path, args, and env, rather than the flat command/args layout other clients use:
{
"context_servers": {
"tavily-mcp": {
"command": {
"path": "npx",
"args": ["-y", "tavily-mcp"],
"env": {
"TAVILY_API_KEY": "tvly-YOUR_API_KEY"
}
}
}
}
}Restart the Agent Panel and test
Zed picks up settings changes live, but the agent side is the part that needs a nudge: close and reopen the Agent Panel (or restart Zed entirely) so it re-handshakes with context servers. In the panel's settings view you should see tavily-mcp listed with a healthy indicator and its tools enumerated.
Test with a prompt that needs the live web — "search for the most recent Zed stable release notes" — and confirm the agent invokes the Tavily search tool rather than answering from memory.
Troubleshooting on Zed
Server not listed: check the JSON shape first. The single most common Zed mistake is pasting a flat "command": "npx" string from another client's guide — Zed expects "command": { "path": ..., "args": [...] }. Zed's inline settings validation catches syntax errors but not shape mistakes.
Spawn failures: open the Zed log (zed: open log from the command palette) to see why the process died — typically npx missing from the PATH Zed inherited. Launching Zed from a terminal (zed .) gives it your shell environment and is the quickest diagnostic. If tools appear but searches error out, the TAVILY_API_KEY value is wrong or over quota; fix it and restart the panel.
Listing details
You can see tavily-mcp's live tool list on its Loomal listing at https://loomal.ai/marketplace/tavily-mcp. The server itself is open source (github.com/tavily-ai/tavily-mcp); search volume is metered by Tavily under your key. Loomal indexes the wider search category too, including x402-ready servers that agents pay per call in USDC on Base — from $0.01 a call — instead of holding API keys at all.
FAQ
How do I install tavily-mcp in Zed?
Add a context_servers entry to ~/.config/zed/settings.json with a command object — path npx, args ["-y", "tavily-mcp"], and TAVILY_API_KEY in env — then reopen the Agent Panel so Zed reconnects to its context servers.
Why is my config ignored when it works in Cursor?
Zed's shape differs: the top-level key is context_servers (not mcpServers) and the launch spec is a nested command object with a path field. Translate the config rather than pasting it verbatim.
Where does Zed log MCP server errors?
Run zed: open log from the command palette. Spawn failures, handshake errors, and the server's stderr land there — it's the first place to look when tavily-mcp doesn't show up in the Agent Panel.
Do I need to restart all of Zed after editing settings?
Usually not — closing and reopening the Agent Panel makes it re-handshake with context servers. A full restart is the fallback if the panel still shows a stale server list or old env values.
More MCP servers for Zed.
Browse Loomal's index — live tool lists on every listing.