tavily-ai/tavily-mcp

The Tavily MCP server provides:
- search, extract, map, crawl tools
- Real-time web search capabilities through the tavily-search tool
- Intelligent data extraction from web pages via the tavily-extract tool
- Powerful web mapping tool that creates a structured map of website
- Web crawler that systematically explores websites
📚 Helpful Resources
- Tutorial on combining Tavily MCP with Neo4j MCP server
- Tutorial on integrating Tavily MCP with Cline in VS Code
Remote MCP Server
Connect directly to Tavily's remote MCP server instead of running it locally. This provides a seamless experience without requiring local installation or configuration.
Simply use the remote MCP server URL with your Tavily API key:
Get your Tavily API key from tavily.com.
Alternatively, you can pass your API key through an Authorization header if the MCP client supports this:
**Note:** When using the remote MCP, you can specify default parameters for all requests by including a DEFAULT_PARAMETERS header containing a JSON object with your desired defaults. Example:
Connect to Claude Code
Claude Code is Anthropic's official CLI tool for Claude. You can add the Tavily MCP server using the claude mcp add command. There are two ways to authenticate:
Option 1: API Key in URL
Pass your API key directly in the URL. Replace with your actual Tavily API key:
Option 2: OAuth Authentication Flow
Add the server without an API key in the URL:
After adding, you'll need to complete the authentication flow:
1. Run claude to start Claude Code
2. Type /mcp to open the MCP server management
3. Select the Tavily server and complete the authentication process
**Tip:** Add --scope user to either command to make the Tavily MCP server available globally across all your projects:
Once configured, you'll have access to the Tavily search, extract, map, and crawl tools.
Connect to Cursor
Click the ⬆️ Add to Cursor ⬆️ button, this will do most of the work for you but you will still need to edit the configuration to add your API-KEY. You can get a Tavily API key here.
once you click the button you should be redirect to Cursor ...
Step 1
Click the install button
Step 2
You should see the MCP is now installed, if the blue slide is not already turned on, manually turn it on. You also need to edit the configuration to include your own Tavily API key.
Step 3
You will then be redirected to your mcp.json file where you have to add your-api-key.
Remote MCP Server OAuth Flow
The Tavily Remote MCP server supports secure OAuth authentication, allowing you to connect and authorize seamlessly with compatible clients.
How to Set Up OAuth Authentication
**A. Using MCP Inspector:**
* Open the MCP Inspector and click "Open Auth Settings".
* Select the OAuth flow and complete these steps:
1. Metadata discovery
2. Client registration
3. Preparing authorization
4. Request authorization and obtain the authorization code
5. Token request
6. Authentication complete
Once finished, you will receive an access token that lets you securely make authenticated requests to the Tavily Remote MCP server.
**B. Using other MCP Clients (Example: Cursor):**
You can configure your MCP client to use OAuth without including your Tavily API key in the URL. For example, in your mcp.json: