Skip to main content
Glama
Tavily Search MCP Server

Tavily Search MCP Server

by online111111

Tavily Search MCP Server

A Model Context Protocol (MCP) server for the Tavily Search API with automatic multi-key fallback. Built with FastMCP.

Features

  • 🔄 Multi-key auto fallback — automatically rotates through TAVILY_API_KEY_1, TAVILY_API_KEY_2, etc. when rate-limited

  • 🌐 Web search — tavily_search for general web search

  • 📄 Content extraction — tavily_extract to get content from URLs

  • 🗺️ Crawl & Map — tavily_crawl / tavily_map for website structure

  • 🔬 Deep Research — tavily_research_create / tavily_research_get for AI-powered research

  • 📊 Usage tracking — tavily_usage to check API quota

Related MCP server: Tavily MCP Server

Quick Start

{
  "mcpServers": {
    "tavily-search": {
      "command": "uvx",
      "args": ["tavily-search-mcp-server"]
    }
  }
}

Environment Variables

Variable

Required

Description

TAVILY_API_KEY_1

Yes

Primary Tavily API key

TAVILY_API_KEY_2..5

No

Fallback keys for auto-rotation

The server automatically discovers TAVILY_API_KEY_* env vars and falls back through them on 429 errors. Also supports single TAVILY_API_KEY for backward compatibility.

Available Tools

Tool

Description

tavily_search

Search the web with configurable depth, topic, time range

tavily_extract

Extract content from one or more URLs

tavily_crawl

Crawl a website with depth/breadth control

tavily_map

Map website structure

tavily_search_context

Search with raw content results

tavily_research_create

Create a deep research task

tavily_research_get

Get research task status/results

tavily_usage

Check API usage/quota

License

MIT

Available Tools

8 tools
tavily_crawlC

爬取网站。多 API Key 自动轮换。

Inputs: url (required), max_depth, max_breadth, limit, +13 more. Returns: result

tavily_extractC

从 URL 提取内容。多 API Key 自动轮换。

Inputs: urls (required), extract_depth, include_images, format, +5 more. Returns: result

tavily_mapC

绘制网站结构地图。多 API Key 自动轮换。

Inputs: url (required), max_depth, max_breadth, limit, +9 more. Returns: result

tavily_research_createC

创建 Tavily 深度研究任务。多 API Key 自动轮换。

Inputs: input (required), model, output_schema, stream, +2 more. Returns: result

tavily_research_getC

查询 Tavily 深度研究任务状态/结果。多 API Key 自动轮换。

Inputs: request_id (required). Returns: result

tavily_search_contextC

搜索并返回带原始内容的上下文结果。多 API Key 自动轮换。

Inputs: query (required), search_depth, topic, days, +7 more. Returns: result

tavily_usageA

查询 Tavily 使用量/额度。多 API Key 自动轮换。

Inputs: no named parameters. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: search, search with context, crawl, extract, map, research creation, research retrieval, and usage monitoring. No overlap or ambiguity.

    Naming Consistency5/5

    All tools follow the consistent 'tavily_<verb>' pattern, using clear action verbs like search, crawl, extract, map, research_create, research_get, and usage. No mixing of conventions.

    Tool Count5/5

    8 tools is appropriate for a web search and research service, covering core operations without being excessive or insufficient.

    Completeness4/5

    The tool surface covers search, crawling, extraction, site mapping, research tasks, and usage monitoring. Minor gap: no tool to list or cancel research tasks, but core workflows are covered.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      Provides AI-powered web search capabilities using Tavily's search API, enabling LLMs to perform sophisticated web searches, get direct answers to questions, and search recent news articles.
      72
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides AI assistants with real-time web search, intelligent data extraction from web pages, website mapping, and web crawling capabilities through Tavily's API. Enables comprehensive web research and content analysis through natural language interactions.
      19,428 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to perform real-time web searches, extract data from web pages, map website structures, and crawl websites using the Tavily API.
      85 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides web search capabilities using the Tavily API, enabling AI models to search the internet and retrieve up-to-date information.
      -