mcp-tavily-search

Notice

Features

• Advanced web search capabilities through Tavily API

• AI-generated summaries of search results

• Domain filtering for higher quality results

• Configurable search depth and parameters

• Context generation for RAG applications

• Direct question answering capabilities

• Response caching with TTL support

• Multiple response formats (text, JSON, markdown)

• Structured result formatting optimized for LLMs

• Built on the Model Context Protocol

Configuration

Cline Configuration

Claude Desktop with WSL Configuration

Environment Variables

• `TAVILY_API_KEY`: Your Tavily API key (required)

API

tavily_search

• `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

tavily_get_search_context

• `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

tavily_qna_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

Domain Filtering

• `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

Development

Setup

1. Clone the repository

2. Install dependencies:

1. Build the project:

1. Run in development mode:

Publishing

1. Create a changeset:

1. Version the package:

1. Publish to npm:

Contributing

License

Acknowledgments

• Built on the [Model Context Protocol](https://github.com/modelcontextprotocol)

• Powered by [Tavily Search API](https://tavily.com)