Tavily MCP server

Tavily's official remote server for real-time web search, page extraction, site mapping, crawling and multi-step research. Sign in through OAuth, or use a Tavily API key with the local package.

Remote (HTTP)OAuth

Set up Tavily

Configuration examples, not tested connections. Replace placeholders and review the upstream documentation before use.

Claude Code

Run in your terminal.

claude mcp add --transport http tavily https://mcp.tavily.com/mcp

Cursor

Merge into ~/.cursor/mcp.json

{
  "mcpServers": {
    "tavily": {
      "url": "https://mcp.tavily.com/mcp"
    }
  }
}

Codex

Run in your terminal.

codex mcp add tavily --url https://mcp.tavily.com/mcp
codex mcp login tavily

Gemini CLI

Merge into ~/.gemini/settings.json

{
  "mcpServers": {
    "tavily": {
      "httpUrl": "https://mcp.tavily.com/mcp"
    }
  }
}

OpenCode

Merge into ~/.config/opencode/opencode.jsonc

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "tavily": {
      "type": "remote",
      "url": "https://mcp.tavily.com/mcp",
      "enabled": true
    }
  }
}

VS Code

Merge into .vscode/mcp.json

{
  "servers": {
    "tavily": {
      "type": "http",
      "url": "https://mcp.tavily.com/mcp"
    }
  }
}

Using more than one server?Add to a config with other servers

Step-by-step setup guides: Claude Code and Codex CLI, Cursor and VS Code. In Claude Desktop, add the URL as a custom connector. This is a remote server with OAuth sign-in; see remote vs local servers and authentication and security basics.

Overview

Tavily is a search API built for AI agents, and its MCP server is maintained in tavily-ai/tavily-mcp, which had commits in September and October 2026. Tavily hosts the server at https://mcp.tavily.com/mcp, and the same project is published as the tavily-mcp npm package for local use.

The server provides five working tools. tavily_search runs a real-time web search with options such as search depth and the number of results. tavily_extract pulls clean content from given URLs. tavily_map builds a structured map of a website, and tavily_crawl follows its links to collect pages. tavily_research performs a multi-step research task and returns a combined answer. Together they cover most of what an agent needs to look things up and read sources.

The example adds the remote URL without a key, which uses Tavily's OAuth flow. In Claude Code, run /mcp and finish signing in to Tavily; in Codex, run codex mcp login tavily. Upstream also documents passing an API key in the URL as ?tavilyApiKey=. We do not show that here, because the key would be stored in your client configuration in plain text. If you prefer a key, the local package reads TAVILY_API_KEY from the environment.

Example tools

  • tavily_search
  • tavily_extract
  • tavily_map
  • tavily_crawl
  • tavily_research

Tool names are upstream examples. The server's live tool list can differ.

Browse Developer Tools servers

Sources

This page was written from the upstream documentation below and last reviewed on 11 October 2026. Listing is not a security or compatibility endorsement. Report a correction through the contact page.