Tavily MCP Server with Proxy Support

A Model Context Protocol server that provides AI-powered web search capabilities using Tavily's search API, with added support for HTTP/HTTPS proxy configurations. This server enables LLMs to perform sophisticated web searches through proxy servers, get direct answers to questions, and search recent news articles with AI-extracted relevant content.

Features

All original Tavily MCP Server features
HTTP/HTTPS proxy support through environment variables
Enhanced logging for proxy configurations
Robust error handling for proxy-related issues

Available Tools

tavily_web_search - Performs comprehensive web searches with AI-powered content extraction.
- query (string, required): Search query
- max_results (integer, optional): Maximum number of results to return (default: 5, max: 20)
- search_depth (string, optional): Either "basic" or "advanced" search depth (default: "basic")
tavily_answer_search - Performs web searches and generates direct answers with supporting evidence.
- query (string, required): Search query
- max_results (integer, optional): Maximum number of results to return (default: 5, max: 20)
- search_depth (string, optional): Either "basic" or "advanced" search depth (default: "advanced")
tavily_news_search - Searches recent news articles with publication dates.
- query (string, required): Search query
- max_results (integer, optional): Maximum number of results to return (default: 5, max: 20)
- days (integer, optional): Number of days back to search (default: 3)

Installation

Use `pip`

pip install mcp-tavily-proxy

or if you have uv installed:

uv pip install mcp-tavily-proxy

Build from Source

Clone this repository and build and install the program:

git clone https://github.com/tulong66/mcp-tavily-proxy.git
cd mcp-tavily-proxy
uv build
uv pip install .

Configuration

API Key and Proxy Settings

The server requires a Tavily API key and supports proxy configuration through environment variables:

Set required environment variables:

# Tavily API Key
export TAVILY_API_KEY=your_api_key_here

# Proxy Settings (if needed)
export HTTP_PROXY=http://your-proxy:port
export HTTPS_PROXY=http://your-proxy:port

Or provide API key as a command-line argument:

python -m mcp_server_tavily --api-key=your_api_key_here

Configure for Claude.app

Add to your Claude settings:

{
  "mcpServers": {
    "tavily": {
      "command": "python",
      "args": ["-m", "mcp_server_tavily"]
    },
    "env": {
      "TAVILY_API_KEY": "your_api_key_here",
      "HTTP_PROXY": "http://your-proxy:port",
      "HTTPS_PROXY": "http://your-proxy:port"
    }
  }
}

Examples

For a regular search:

Tell me about Anthropic's newly released MCP protocol

To generate a report with explicit exclusions:

Tell me about redwood trees. Please use MLA format in markdown syntax and include the URLs in the citations. Exclude Wikipedia sources.

For news search:

Give me the top 10 AI-related news in the last 5 days

Debugging

Enable debug logging to see detailed proxy configuration information:

export TAVILY_LOG_LEVEL=DEBUG
python -m mcp_server_tavily

You can also use the MCP inspector:

npx @modelcontextprotocol/inspector python -m mcp_server_tavily

Contributing

Contributions are welcome! Please feel free to submit pull requests to help improve the proxy support or add new features.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

This project is based on the original mcp-tavily with added proxy support functionality.

This server cannot be installed

security - not tested

license - not found

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables LLMs to perform sophisticated web searches through proxy servers using Tavily's API, supporting comprehensive web searches, direct question answering, and recent news article retrieval with AI-extracted content.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Tavily Search Server
spences10
A
security
A
license
A
quality
Integrates Tavily's search API with LLMs to provide advanced web search capabilities, including intelligent result summaries, domain filtering for quality control, and configurable search parameters.
Last updated -
3
64
9
JavaScript
MIT License
tavily-search-mcp-server
apappascs
A
security
A
license
A
quality
An MCP server implementation that integrates the Tavily Search API, providing optimized search capabilities for LLMs.
Last updated -
1
TypeScript
MIT License
MCP JinaAI Search Server
spences10
A
security
A
license
A
quality
Enables efficient web search integration with Jina.ai's Search API, offering clean, LLM-optimized content retrieval with support for various content types and configurable caching.
Last updated -
1
22
3
JavaScript
MIT License
Tavily MCP Serverofficial
tavily-ai
A
security
A
license
A
quality
This server enables AI systems to integrate with Tavily's search and data extraction tools, providing real-time web information access and domain-specific searches.
Last updated -
2
6,005
403
JavaScript
MIT License

View all related MCP servers

Tavily MCP Server with Proxy Support