tavily-pool-mcp

A local Model Context Protocol server that exposes a Tavily search tool and rotates across multiple Tavily API keys.

Features

• Exposes tavily_search as an MCP tool
• Rotates across multiple Tavily API keys
• Retries with another key on 401, 403, or 429
• Works with OpenCode and other MCP-compatible clients

Requirements

• Node.js 18+
• Tavily API keys

Install

npm install

Configuration

Set TAVILY_API_KEYS as a space, comma, or semicolon separated list:

export TAVILY_API_KEYS="tvly-dev-key-1 tvly-dev-key-2 tvly-dev-key-3"

On Windows PowerShell:

$env:TAVILY_API_KEYS="tvly-dev-key-1 tvly-dev-key-2 tvly-dev-key-3"

Run

npm start

npm start starts a stdio MCP server, so the terminal will wait for MCP input. This is expected.

OpenCode Config

Add this to your OpenCode opencode.json:

{
  "mcp": {
    "tavily-pool": {
      "type": "local",
      "enabled": true,
      "command": ["node", "C:/path/to/tavily-pool-mcp/src/index.mjs"],
      "environment": {
        "TAVILY_API_KEYS": "{env:TAVILY_API_KEYS}"
      }
    }
  }
}

Tool

tavily_search

Arguments:

• query: search query
• max_results: 1-20, default 5
• search_depth: basic or advanced, default basic
• include_answer: boolean, default false
• include_raw_content: boolean, default false

Security

Do not commit real API keys. Use environment variables or a secret manager.

License

MIT