home / mcp / tavily mcp server

Tavily MCP Server

Provides Tavily MCP tools for web search, extraction, mapping, and crawling via an MCP client.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "avac22-tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "TAVILY_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You integrate Tavily’s MCP server with your AI assistant to enable real-time web searching, data extraction, mapping of websites, and structured crawling through a simple, secure interface. By connecting your MCP client to Tavily MCP, you gain powerful web intelligence capabilities that you can deploy in conversations and automated workflows.

How to use

You connect your MCP client to the Tavily MCP server and then invoke its tools from your AI assistant. The Tavily MCP server provides four core tools: tavily-search for real-time web search with filtering, tavily-extract to pull structured content from pages, tavily-map to create a structured map of a website, and tavily-crawl to systematically explore sites. In practice, you initiate a search, extract relevant content, map sources for quick navigation, and crawl related pages to build a broader knowledge picture. When using Claude Desktop, you will typically see a hammer icon indicating available MCP tools; click it to choose tavily-search or tavily-extract as needed.

How to install

Prerequisites include a Tavily API key, Claude Desktop or Cursor, and Node.js (v20 or higher). Verify Node.js with node --version and ensure you can run npm/npx commands.

Install the Tavily MCP server locally using NPX:

npx -y [email protected]

Alternatively, you can install via Smithery to set up the Tavily MCP Server for Claude Desktop automatically:

npx -y @smithery/cli install @tavily-ai/tavily-mcp --client claude

You should integrate the server with an MCP client rather than running it in isolation. The following configuration snippets show how to wire Tavily MCP into common clients.

Additional sections

Configuration and usage notes for common MCP clients are provided below. Include your Tavily API key in the environment when starting the server.

Security tip: keep your Tavily API key secret and only expose it to trusted MCP clients. Rotate keys if you suspect compromise.

If you encounter issues starting the server, ensure your environment has Node.js 20+ and that npx can locate the Tavily MCP package.

Available tools

tavily-search

Real-time web search tool with filtering and domain-specific capabilities to fetch up-to-date information from the web.

tavily-extract

Content extraction tool that pulls structured data from web pages, enabling focused content retrieval.

tavily-map

Web mapping tool that creates a structured map of a website for easy navigation and analysis.

tavily-crawl

Web crawler that systematically explores websites to build a comprehensive view of linked content.