MCP Tavily Search Server

This repository is no longer maintained.

The functionality of this tool is now available inmcp-omnisearch, which combines multiple MCP tools in one unified package.

{ "mcpServers": { "mcp-tavily-search": { "command": "npx", "args": ["-y", "mcp-tavily-search"], "env": { "TAVILY_API_KEY": "your-tavily-api-key" } } } }

For WSL environments, add this to your Claude Desktop configuration:

{ "mcpServers": { "mcp-tavily-search": { "command": "wsl.exe", "args": [ "bash", "-c", "source ~/.nvm/nvm.sh && TAVILY_API_KEY=your-tavily-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-tavily-search" ] } } }

The server requires the following environment variable:

- TAVILY_API_KEY: Your Tavily API key (required)

The server implements three MCP tools with configurable parameters:

Search the web using Tavily Search API, optimized for high-quality, factual results.

- query(string, required): Search query
- search_depth(string, optional): "basic" (faster) or "advanced" (more thorough). Defaults to "basic"
- topic(string, optional): "general" or "news". Defaults to "general"
- days(number, optional): Number of days back to search (news topic only). Defaults to 3
- time_range(string, optional): Time range for results ('day', 'week', 'month', 'year' or 'd', 'w', 'm', 'y')
- max_results(number, optional): Maximum number of results. Defaults to 5
- include_answer(boolean, optional): Include AI-generated summary. Defaults to true
- include_images(boolean, optional): Include related images. Defaults to false
- include_image_descriptions(boolean, optional): Include image descriptions. Defaults to false
- include_raw_content(boolean, optional): Include raw HTML content. Defaults to false
- include_domains(string[], optional): List of trusted domains to include
- exclude_domains(string[], optional): List of domains to exclude
- response_format(string, optional): 'text', 'json', or 'markdown'. Defaults to 'text'
- cache_ttl(number, optional): Cache time-to-live in seconds. Defaults to 3600
- force_refresh(boolean, optional): Force fresh results ignoring cache. Defaults to false

Generate context for RAG applications using Tavily search.

- query(string, required): Search query for context generation
- max_tokens(number, optional): Maximum length of generated context. Defaults to 2000
- search_depth(string, optional): "basic" or "advanced". Defaults to "advanced"
- topic(string, optional): "general" or "news". Defaults to "general"
- Other parameters same as tavily_search

Get direct answers to questions using Tavily search.

- query(string, required): Question to be answered
- include_sources(boolean, optional): Include source citations. Defaults to true
- search_depth(string, optional): "basic" or "advanced". Defaults to "advanced"
- topic(string, optional): "general" or "news". Defaults to "general"
- Other parameters same as tavily_search

The server supports flexible domain filtering through two optional parameters:

- include_domains: Array of trusted domains to include in search results
- exclude_domains: Array of domains to exclude from search results

- Target specific trusted sources for academic or technical searches
- Exclude potentially unreliable or irrelevant sources
- Customize sources based on your specific needs
- Access all available sources when no filtering is specified

{ "include_domains": ["arxiv.org", "science.gov"], "exclude_domains": ["example.com"] }

- Clone the repository
- Install dependencies:

The project uses changesets for version management. To publish:

Contributions are welcome! Please feel free to submit a Pull Request.

MIT License - see theLICENSEfile for details.

- Built on theModel Context Protocol
- Powered byTavily Search API

Unified real-time search engine skill for AI agents.