MCP Directory

How to add Tavily to Cursor

Production-ready MCP server for real-time web search, content extraction, site mapping, and crawling. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 15, 2026 · 2.1k★ · stdio · apikey · official

Cursor config for Tavily

npx -y tavily-mcp@latest
{
  "mcpServers": {
    "tavily": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ],
      "env": {
        "TAVILY_API_KEY": "<your-tavily-api-key>"
      }
    }
  }
}

Setup steps

  1. 1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the Tavily config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of Tavily's tools to confirm it's connected.

Before you start

  • A Tavily API key from https://app.tavily.com (free account available, no credit card)
  • For local use: Node.js v20 or later with npx
  • An MCP-compatible client such as Claude Desktop, Claude Code, or Cursor

What Tavily can do in Cursor

tavily-search

Real-time web search optimized for AI agents.

tavily-extract

Extract clean, structured content from specific URLs.

tavily-crawl

Systematically crawl and explore a website.

tavily-map

Build a structured map of a website's URL structure.

Security

Needs a TAVILY_API_KEY which gates billable API usage; keep it secret and rotate if leaked. Crawl/extract tools fetch arbitrary remote pages, so validate any URLs you pass and treat returned content as untrusted.

Tavily + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Tavily config there under the "mcpServers" key and restart the client.

Is Tavily safe to use with Cursor?

Needs a TAVILY_API_KEY which gates billable API usage; keep it secret and rotate if leaked. Crawl/extract tools fetch arbitrary remote pages, so validate any URLs you pass and treat returned content as untrusted.

Is there a free tier?

Yes. Tavily's free plan includes 1,000 API credits per month with no credit card required. Basic search costs 1 credit and advanced search costs 2 credits; unused credits do not roll over.

Can I use it without installing anything locally?

Yes. Tavily hosts a remote MCP server at mcp.tavily.com that you connect to over HTTP with your API key, so no local install is needed. A local stdio option via npx is also available.

How is it authenticated?

With a Tavily API key, passed either as the TAVILY_API_KEY environment variable (local) or in the remote URL query string. The remote server also supports optional OAuth.

View repo Full Tavily page