Tavily MCP: Documentation
Updated:
Connection
- Remote:
https://mcp.tavily.com/mcp/?tavilyApiKey=<key>(free signup) or anAuthorization: Bearer <key>header; OAuth without a key in the URL is also supported. - Claude Code:
claude mcp add --transport http tavily "https://mcp.tavily.com/mcp/?tavilyApiKey=<key>". - Local:
npx -y tavily-mcp@latestwith theTAVILY_API_KEYenv var (requires Node.js 20+). DEFAULT_PARAMETERS— JSON with default search parameters (include_images, search_depth, max_results);TAVILY_HUMAN_ID— optional user identifier for analytics.
Tools
tavily-search— real-time web search with freshness, domain and depth filters.tavily-extract— extract content from specific pages.tavily-map— build a site's URL map (structure without downloading content).tavily-crawl— systematically crawl a site and extract content from the pages found.
Agent flow
Fresh facts past the cutoff: news, prices, versions, events — with sources.
Pricing
- Free — 1,000 credits/month, no card required (basic search costs 1 credit, advanced search 2 credits per query).
- Paid — from $30/month for 4,000 credits; volume plans drop to about $0.005/credit (e.g. 100,000 credits for $500/month).
- Pay-as-you-go — $0.008 per credit.