Pod

Yes, this is on purpose. Pod is built for agents, so the default page is plain HTML.
Human? View the normal website.
Agent? You probably prefer /mcp/tavily-mcp/issues.md or /mcp/tavily-mcp/issues.json, or Pod over MCP.

Reported issues for tavily-mcp

Pod holds 24 of 46 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to tavily-mcp.

Most discussed

Reduce country names to decrease prompt size

Can you reduce the number of country names or change the prompt in your mcp on https://github.com/tavily-ai/tavily-mcp/blob/main/src/index.ts. We are planning to use your mcp server for our app, reducing the country names can reduce the context size by about 1k tokens. This will definitely reduce our costs as we are planning to use an expensive model

Read the thread · 2025-09-25 · closed · external user · 2 comments

[Q&A] How to set the default args value?

I am using the mcp server like below:

  const config: ClientConfig = {
    mcpServers: {
      tavily_search: {
        command: 'npx',
        args: ['-y', 'tavily-mcp@latest'],
        env: {
          TAVILY_API_KEY: process.env.TAVILY_API_KEY!,
        },
      },
    },

How can I set the default value of the options?

For example, I used the '@langchain/tavily'like below in langchain stack: 

  const tavilyTool = new TavilySearch({
    maxResults: maxResults ?? 5,
    to

[Read the thread](https://github.com/tavily-ai/tavily-mcp/issues/60) · 2025-08-25 · closed · external user · 3 comments

### Use `Authorization` header instead of query param

Configuring a tool that can only use remote MCPs with Tavily is a bit weird because you're essentially forced to leak your API token to everyone in the organization

<img width="395" height="247" alt="Image" src="https://github.com/user-attachments/assets/266b2e35-cf94-46be-b395-9ed01eb1e713" />

It would be better if Tavily supported the industry standard header `Authorization: Bearer <token />` or even a non-standard header.

[Read the thread](https://github.com/tavily-ai/tavily-mcp/issues/59) · 2025-08-23 · closed · external user · 4 comments

### proxy support?

Do you have any plans to support proxy?

We are testing mcp/tavily, but it seems that the functionality to call the Tavily API through a proxy using the http_proxy or https_proxy environment variables has not been implemented. Since we are considering auditing through a proxy in our MCP operations, it would be greatly appreciated if you could add support for this. Thank you.

[Read the thread](https://github.com/tavily-ai/tavily-mcp/issues/30) · 2025-05-04 · closed · external user · 2 comments

### Error getting tool list when using tavily-mcp in VSCode Continue extension

Got error when using VSCode Continue to call tavily-mcp@0.1.4

Message: 
`Error loading resources for MCP Server Tavily Search: MCP error -32601: Method not found`

Install command:
`npm i -g tavily-mcp`

Continue command:
`npx -y tavily-mcp@0.1.4`

Developer Tools' Console message:
`Tavily MCP server running on stdio`

Simple test for this error:

node -e "const { spawn } = require('child_process'); const mcp = spawn('npx', ['tavily-mcp'], { stdio: ['pipe', 'pipe', process.stderr] }); mcp.st

Read the thread · 2025-04-06 · closed · external user · 2 comments

Error: Cannot find package

Hi there， When I use bunx instead of npx, I get the error

Error: Cannot find package 'F:\Temp\bunx-3651528695-tavily-mcp@0.1.4\node_modules\zod\index.js' imported from F:\Temp\bunx-3651528695-tavily-mcp@0.1.4\node_modules\@modelcontextprotocol\sdk\dist\types.js

I checked and found the zod folder is empty. Can this be solved?

Read the thread · 2025-03-29 · closed · external user · 2 comments

not working

Image

Image

"tavily": { "command": "/bin/bash", "args": ["script.sh"] }

Read the thread · 2025-03-22 · closed · external user · 2 comments

on the window vscode bug

{ "mcpServers": { "tavily-mcp": { "command": "npx", "args": ["-y", "tavily-mcp@0.1.3"], "env": { "TAVILY_API_KEY": "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" } } } } it error spawn npx ENOENT spawn npx ENOENT

Read the thread · 2025-02-25 · closed · external user · 7 comments

Most recent

OAuth login fails with CloudFront 403 when Google profile picture URL is long

Summary

Browser OAuth for the remote MCP server (https://mcp.tavily.com/mcp/) fails for some Google accounts. After approving with Google, the redirect to https://app.tavily.com/api/mcp_account_creation?session_token=...&state=... is blocked by CloudFront/WAF with a generic 403 "Request blocked" page before it reaches the app.

Root cause: the session_token JWT embeds the user's Google picture claim. For accounts whose Google profile-picture URL is the long signed `lh3.googleusercont

Read the thread · 2026-08-23 · open · external user · 0 comments

Server is missing an instructions field, leaving agents with no guidance on which tool to use or how they combine

tavily-mcp advertises five overlapping tools (tavily_search, tavily_research, tavily_extract, tavily_crawl, tavily_map) but provides no server-level instructions and no resources/prompts. The only guidance available is five isolated per-tool descriptions. As a result, agents frequently pick the wrong tool or misuse tools (especially tavily_extract and tavily_research), because nothing tells them which tool to start with or how the tools combine.

Tested version

Read the thread · 2026-07-14 · open · external user · 0 comments

tavily_search returns HTTP 400 behind an HTTP proxy

When an HTTP forward proxy is configured via HTTPS_PROXY (e.g. HTTPS_PROXY=http://127.0.0.1:7890), every tool call fails with:

Tavily API error: Request failed with status code 400 Documentation: https://docs.tavily.com/documentation/api-reference/endpoint/search

The 400 is not returned by the Tavily API. It is returned by the nginx reverse proxy in front of api.tavily.com, because the bundled axios (1.16.0) sends the request as plaintext HTTP to port 443 instead of establishing a CONNECT tunn

Read the thread · 2026-07-14 · open · external user · 0 comments

is passing key via get url param - isn't security risk

https://github.com/tavily-ai/tavily-mcp?tab=readme-ov-file#remote-mcp-server

I was going trough tavily-ai -> docs recommend passing api key in URL parameters, concerned on logging of key, and also dump of url string params

Read the thread · 2026-07-06 · open · external user · 1 comment

Proposal: Add BuyWhere MCP — "Research with Tavily, buy with BuyWhere"

Proposal

BuyWhere (BuyWhere/buywhere-mcp) is a structured product catalog and price comparison MCP server. Pairing it with Tavily MCP creates a complete research-to-purchase workflow.

Suggested link

- [BuyWhere MCP](https://github.com/BuyWhere/buywhere-mcp) — Real-time product prices and catalog search. "Research with Tavily, buy with BuyWhere."

The workflow

1. Tavily MCP: research "best budget laptop for coding 20

[Read the thread](https://github.com/tavily-ai/tavily-mcp/issues/181) · 2026-06-21 · open · external user · 0 comments

### Proposal: cross-link complementary MCP packages in README

## Proposal

Add a "Works Well With" section to the tavily-mcp README that cross-links complementary MCP servers.

**Suggested addition:**

> **[@buywhere/mcp-server](https://www.npmjs.com/package/@buywhere/mcp-server)** — Search and compare prices across 11M+ products from Singapore, SEA, and US markets via Model Context Protocol. Research products with Tavily, then get current prices, compare across markets, and find purchase links with BuyWhere.

## Why

Tavily is a web search / research tool

[Read the thread](https://github.com/tavily-ai/tavily-mcp/issues/179) · 2026-06-19 · open · external user · 0 comments

### 工具名重复 tavily_ 前缀，MCP 框架已有命名空间隔离

MCP 宿主会自动给工具名加上服务器名前缀，避免冲突（如 rag_search = 服务器 rag + 工具 search）。但 Tavily MCP 的工具名内部又带了一遍 tavily_ ，导致接入后变成 tavily_tavily_search ，双重冗余。

当前（src/index.ts）工具名：
- tavily_search
- tavily_extract
- tavily_crawl
- tavily_map
- tavily_research

是否有考虑去掉内部的 tavily_ 前缀？这样框架补上命名空间后就是干净的 tavily_search 、tavily_extract 等。

对比： rag MCP 服务器内部就叫 search ，拼出来是 rag_search ，不会有双前缀问题。

同情况似乎也存在于 tavily-ai/tavily-mcp-python 。

[Read the thread](https://github.com/tavily-ai/tavily-mcp/issues/177) · 2026-06-11 · open · external user · 0 comments

### Missing TAVILY_API_KEY throws McpError instead of returning isError: true

## Summary

When `TAVILY_API_KEY` is not set, all 5 tools return a JSON-RPC error (`McpError` / code -32600) instead of a graceful `isError: true` response. The server starts without the key, then every tool invocation throws at the handler level.

## Steps to Reproduce

1. Start the server without setting `TAVILY_API_KEY`:

npx -y tavily-mcp@latest

2. Send any tool call (e.g., `tavily_search` with `{"query": "test"}`)
3. Observe a JSON-RPC error frame instead of a tool result

#

[Read the thread](https://github.com/tavily-ai/tavily-mcp/issues/161) · 2026-04-29 · open · external user · 0 comments

### [Bug] tavily_research hangs forever when model is not specified

## Description

**Broken — omitting model:**
```json
{
  "name": "tavily_research",
  "args": {
 "input": "Research the latest..."
  }
}

Works — explicit mini:

{
  "name": "tavily_research",
  "args": {
    "input": "Research the latest...",
    "model": "mini"
  }
}

The Problem

model is optional in the schema and should default to "auto". But when omitted, the job sits at 202/pending forever

Read the thread · 2026-04-23 · open · external user · 0 comments

[Bug] tavily_research hangs indefinitely on remote MCP, no axios timeout on polling requests causes silent network failure

Environment

Bug Description

tavily_research hangs for 3+ minutes on both short and long queries, then surfaces a network error from the client side. The job never completes, it stays pending on the backend indefinitely.

Root Cause (identified in source)

In src/index.ts, the axios instance is created with no timeout:

this.axios

[Read the thread](https://github.com/tavily-ai/tavily-mcp/issues/157) · 2026-04-23 · closed · external user · 0 comments

### docs: README still shows hyphenated tool names (tavily-search/tavily-extract); server registers underscored since v0.2.13

## Problem

[README.md](https://github.com/tavily-ai/tavily-mcp/blob/main/README.md) currently documents tool usage with hyphenated names:

- `tavily-search`
- `tavily-extract`

But the server has shipped **underscored** names since v0.2.13 (2026-01-23). Verified against `tavily-mcp@0.2.18` in `build/index.js` (lines 95, 180, 221, 291, 344):

- `tavily_search`
- `tavily_extract`
- `tavily_crawl`
- `tavily_map`
- `tavily_research` (added in 0.2.16)

## Why it matters

This bit us when configuring

[Read the thread](https://github.com/tavily-ai/tavily-mcp/issues/154) · 2026-04-19 · open · external user · 0 comments

### [RFC] Agent-native payment gating for Tavily MCP — pay-per-call via x402/MPP

## What this proposes

Adding pay-per-call payment gating to \`tavily-mcp\` so AI agents can pay for searches directly — without requiring human billing accounts.

Tavily already charges for API access. This extends that model to agent-native payments: agents pay small amounts per call via x402 (USDC on Base) or MPP (Stripe's Machine Payments Protocol), with zero changes to the existing server logic.

## Working demo

I've built a payment-gated fork: **[github.com/tomopay/tavily-mcp](https://git

[Read the thread](https://github.com/tavily-ai/tavily-mcp/issues/139) · 2026-03-31 · open · external user · 0 comments

### Progress updates from MCP Server Tools

Is there a way to send progress updates from the tavily MCP tools to the clients accessing it (can be caught via callbacks from the client)?

**Example**: 
Reading the site: https://...
Crawling multiple sites for deepresearch..
etc.,

[Read the thread](https://github.com/tavily-ai/tavily-mcp/issues/135) · 2026-03-23 · open · external user · 0 comments

### [Bug Report] tavily-ai/tavily-mcp

## Server Information
**Server:** tavily-ai/tavily-mcp
**Connection Type:** Local

## Description
When attempting to add the Tavily MCP server, the Smithery CLI consistently returns a **404 Initialization failed** error. Despite being logged in and attempting both global installation and `npx` execution, the CLI points to a non-functional proxy URL (`https://server.smithery.ai/...`).

## Steps to Reproduce
1. Install Smithery CLI globally: `npm install -g @smithery/cli`
2. Authenticate via: `smi

[Read the thread](https://github.com/tavily-ai/tavily-mcp/issues/134) · 2026-03-21 · open · external user · 0 comments

### Bug Report: Node.js v24 Compatibility - ERR_UNSUPPORTED_DIR_IMPORT with zod v3

## Description

Node.js v24 changed ES Module resolution rules, causing zod v3 directory imports to fail when running tavily-mcp server.

## Error Message

    Error [ERR_UNSUPPORTED_DIR_IMPORT]: Directory import 'C:\Users\...\AppData\Local\npm-cache\_npx\...\node_modules\zod\v3' is not supported resolving ES modules imported from ...\zod-to-json-schema\dist\esm\selectParser.js
        at finalizeResolution (node:internal/modules/esm/resolve:263:11)
        at moduleResolve (node:internal/module

[Read the thread](https://github.com/tavily-ai/tavily-mcp/issues/132) · 2026-03-18 · open · external user · 0 comments

### Tavily OAuth resets every 12 hours

Every 12 hours, Tavily MCP via OAuth resets, causing issues for long-running agents. Is it possible to extend the auth window longer?

[Read the thread](https://github.com/tavily-ai/tavily-mcp/issues/130) · 2026-03-17 · open · external user · 0 comments

The remaining reports are on [the project's issue tracker](https://github.com/tavily-ai/tavily-mcp/issues).