Skip to main content
Glama
whfzdxhst

Tavily Search MCP

by whfzdxhst

Tavily Search MCP

Tavily Search MCP is an MCP service based on Streamable HTTP that wraps Tavily's web search and webpage content extraction capabilities into MCP tools.

Features

  • web_search: Performs a web search based on query keywords.

  • web_fetch: Extracts readable text content from a webpage URL.

Related MCP server: tavily-mcp

Environment Requirements

  • Python 3.11+

  • Tavily API Key

  • An MCP client that supports streamable_http

Installation

First create and activate your own Python virtual environment, then install the dependencies and the current project:

python -m pip install -r requirements.txt
python -m pip install -e .

Copy the environment variable template:

cp .env.example .env

Fill in the configuration in .env:

TAVILY_API_KEY=tvly-your-api-key
MCP_SERVER_HOST=127.0.0.1
MCP_SERVER_PORT=21029
MCP_SERVER_PATH=/mcp
MCP_ALLOWED_HOSTS=127.0.0.1,127.0.0.1:21029,localhost,localhost:21029
MCP_ALLOWED_ORIGINS=*

If deploying to a server, set MCP_SERVER_HOST to 0.0.0.0 and add your public domain or access hostname to MCP_ALLOWED_HOSTS.

Start the Service

python -m tavily_search_mcp.server

Default local MCP address:

http://127.0.0.1:21029/mcp

Health check:

curl http://127.0.0.1:21029/health

Test Client

List MCP tools:

python -m tavily_search_mcp.client --url http://127.0.0.1:21029/mcp list-tools

Call web search:

python -m tavily_search_mcp.client --url http://127.0.0.1:21029/mcp web-search "Tavily Python SDK" --max-results 2

Call webpage content extraction:

python -m tavily_search_mcp.client --url http://127.0.0.1:21029/mcp web-fetch "https://docs.tavily.com/"

MCP Client Configuration

Local service example:

{
  "mcpServers": {
    "tavily-search": {
      "type": "streamable_http",
      "url": "http://127.0.0.1:21029/mcp",
      "headers": {}
    }
  }
}

Remote service example:

{
  "mcpServers": {
    "tavily-search": {
      "type": "streamable_http",
      "url": "https://your-domain.example/mcp",
      "headers": {}
    }
  }
}

Deploy to Server

You can use the deployment script in the repository to upload and start the service with your own SSH key:

.\scripts\deploy_remote.ps1 -HostName "your-server.example" -User "ubuntu" -IdentityFile "<path-to-private-key>"

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers