home / mcp / tavily mcp server

Tavily MCP Server

A Model Context Protocol (MCP) server that provide search by tavily.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "y7ut-mcp-tavily-search": {
      "command": "mcp-tavily-search",
      "args": [
        "run",
        "tvly-*******************"
      ]
    }
  }
}

You have an MCP server that enables searching Tavily data through a dedicated search endpoint. It runs as an MCP server you can start locally or via a container, and you can query it using an MCP client to perform Tavily-based searches.

How to use

To use this MCP server, start it with one of the provided MCP execution methods and then issue a search via your MCP client. You can run the server locally using the built-in command or start it inside a Docker container. The available tool is designed to perform Tavily-based news searches using your chosen parameters.

How to install

Prerequisites: you need a working Go environment or Docker installed on your system. You also need a client capable of communicating with MCP servers.

go install github.com/y7ut/mcp-tavily-search@latest

If you prefer to run using Docker, you can pull and run the container with the specified Tavily TVLY token placeholder.

{
  "mcpServers": {
    "tavily": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "docker.ijiwei.com/mcp/mcp-tavily-search:latest",
        "run",
        "tvly-*******************"
      ]
    }
  }
}

Alternatively, you can configure the server to run directly as a Go binary if you built it locally.

{
  "mcpServers": {
    "tavily": {
      "command": "mcp-tavily-search",
      "args": [
        "run",
        "tvly-*******************"
      ]
    }
  }
}

Additional sections

Configuration notes: the MCP server can be started using either a direct binary command or through Docker. Use the direct command if you have the binary installed via Go, or use the Docker approach if you prefer containerization. Ensure your mcpServers configuration uses the exact command and arguments shown.

Configuration and tools

The MCP server exposes a single tool for performing Tavily searches.

{
  "tool": "search_news",
  "parameters": {
    "keyword": "",
    "days": 7,
    "limit": 5,
    "search_depth": "basic",
    "topic": "news"
  }
}

Available tools

search_news

Performs Tavily-based searches with configurable keywords, time window, result limit, search depth, and topic.