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_searchtavily_extracttavily_maptavily_crawltavily_research
Tool names are upstream examples. The server's live tool list can differ.
Related 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.