Tavily MCP Server

Local stdio MCP proxy with lazy Tavily API key failover

Remote serverstreamable-httpTypeScript

What is the Tavily MCP server?

Most developer tooling work still happens through a UI a human drives. Tavily MCP server moves it into the conversation instead. Local stdio MCP proxy with lazy Tavily API key failover.

The short version

它将 Tavily 上游提供的工具定义、参数和调用结果转发给 Agent,并负责管理多个 API Key。当当前 Key 的额度耗尽、受到限流或失效时,代理会自动切换到下一个 Key, 无需修改 Agent 的提示词或工具调用方式。

Getting it running

Because this one is hosted, setup is mostly authentication — you point your client at the endpoint and approve access. Nothing runs on your machine, so there is no runtime to keep patched.

The tools it exposes

The server publishes 4 tools. What each one is for:

  • TAVILY_API_KEYS — The TAVILY_API_KEYS tool exposed by this server
  • TAVILY_MCP_URL — The TAVILY_MCP_URL tool exposed by this server
  • TAVILY_PROXY_LOG_LEVEL — The TAVILY_PROXY_LOG_LEVEL tool exposed by this server
  • TAVILY_RESET_GRACE_SECONDS — Tavily 说明月度额度在每月第一天重置,但 Usage API 不提供精确重置时刻。本工具会在 下个月 UTC 1 日 00:00 后等待该缓冲时间,再检查旧 Key 是否恢复额度。

What it needs from you

Configuration is passed through the environment: TAVILY_API_KEYS, TAVILY_PROXY_LOG_LEVEL, TAVILY_MCP_URL. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Things to watch

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Tavily's toolset — TAVILY_API_KEYS, TAVILY_MCP_URL, TAVILY_PROXY_LOG_LEVEL and 1 more — is a fair guide to whether it matches your workflow. It is maintained by GitHub Actions; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Tavily's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Available tools

ToolWhat it does
TAVILY_API_KEYSThe TAVILY_API_KEYS tool exposed by this server.
TAVILY_MCP_URLThe TAVILY_MCP_URL tool exposed by this server.
TAVILY_PROXY_LOG_LEVELThe TAVILY_PROXY_LOG_LEVEL tool exposed by this server.
TAVILY_RESET_GRACE_SECONDSTavily 说明月度额度在每月第一天重置,但 Usage API 不提供精确重置时刻。本工具会在 下个月 UTC 1 日 00:00 后等待该缓冲时间,再检查旧 Key 是否恢复额度。

How to install the Tavily MCP server

{
  "mcpServers": {
    "tavily": {
      "command": "npx",
      "args": ["-y", "tavily-proxy-mcp"],
      "env": {
        "TAVILY_API_KEYS": "tvly-key1,tvly-key2,tvly-key3"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
TAVILY_API_KEYSCredential the server authenticates with.Yes
TAVILY_PROXY_LOG_LEVELConfiguration value read at startup.Optional
TAVILY_MCP_URLEndpoint or connection string the server talks to.Yes

Example prompts to try

  • Use Tavily to TAVILY API KEYS.
  • Use Tavily to TAVILY MCP URL.
  • Use Tavily to TAVILY PROXY LOG LEVEL.

Frequently asked questions

It connects Tavily to MCP-compatible AI assistants such as Claude and Cursor, exposing 4 tools (TAVILY_API_KEYS, TAVILY_MCP_URL, TAVILY_PROXY_LOG_LEVEL, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Tavily directly.