mcp-tavily-search

A Model Context Protocol (MCP) server for integrating Tavily's search API with LLMs. This server provides intelligent web search capabilities optimized for high-quality, factual results.

Features

🔍 Advanced web search capabilities through Tavily API
🤖 AI-generated summaries of search results
🎯 Domain filtering for higher quality results
📊 Configurable search depth
🔄 Structured result formatting optimized for LLMs
🏗️ Built on the Model Context Protocol

Configuration

This server requires configuration through your MCP client. Here are examples for different environments:

Cline Configuration

Add this to your Cline MCP settings:

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

Claude Desktop with WSL Configuration

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"
			]
		}
	}
}

Environment Variables

The server requires the following environment variable:

TAVILY_API_KEY: Your Tavily API key (required)

API

The server implements a single MCP tool with configurable parameters:

tavily_search

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

Parameters:

query (string, required): Search query
search_depth (string, optional): "basic" (faster) or "advanced" (more thorough). Defaults to "basic"
include_answer (boolean, optional): Include AI-generated summary. Defaults to true
include_domains (string[], optional): List of trusted domains to include
exclude_domains (string[], optional): List of domains to exclude

Default included domains:

arxiv.org
scholar.google.com
science.gov
wikipedia.org
github.com
stackoverflow.com
developer.mozilla.org

Default excluded domains:

facebook.com
twitter.com
instagram.com
tiktok.com

Development

Setup

Clone the repository
Install dependencies:

pnpm install

Build the project:

pnpm build

Run in development mode:

pnpm dev

Publishing

The project uses changesets for version management. To publish:

Create a changeset:

pnpm changeset

Version the package:

pnpm changeset version

Publish to npm:

pnpm release

Contributing

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

License

MIT License - see the LICENSE file for details.

Acknowledgments

Built on the Model Context Protocol
Powered by Tavily Search API