# io.github.tavily-ai/tavily-mcp (npm · tavily-mcp)

MCP server for advanced web search using Tavily

- Trust score: 60/100 (medium)
- Change this week: +17
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `tavily-mcp`: 60/100 (this document), [markdown](https://verifymcp.io/servers/tavily-ai-tavily-mcp/tavily-mcp.md), [page](https://verifymcp.io/servers/tavily-ai-tavily-mcp/tavily-mcp)

## Channel facts

- Registry: `npm`
- Package: `tavily-mcp`
- Version: `0.2.15`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 70/100
  - No malware found by supply-chain analysis.
  - CVE check failed: a known high-severity CVE affects @modelcontextprotocol/sdk 1.25.2, a direct dependency. A fixed version is available.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (122 of 123), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 23 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 57/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 1017 tokens (~254/item across 4 items; 4 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add tavily-ai-tavily-mcp -- npx -y tavily-mcp
```

### Codex

```bash
codex mcp add tavily-ai-tavily-mcp -- npx -y tavily-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "tavily-ai-tavily-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "tavily-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add tavily-ai-tavily-mcp --command npx --arg -y --arg tavily-mcp
```

### Hermes

```yaml
mcp_servers:
  tavily-ai-tavily-mcp:
    command: "npx"
    args: ["-y", "tavily-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "tavily-ai-tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 60, +1)

No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-02 (score 59, +36)

- [security regression] CVE-2026-25536 affects this package: high
- [security regression] GHSA-frvp-7c67-39w9 affects this package: high
- [security regression] Provenance: unverified → fail
- [security regression] Known CVEs: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Capabilities: pass → unverified
- [functional improvement] Stability: unverified → 0.20
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] Schema quality: unverified → good
- [functional] Licence: MIT

### 2026-08-01 (score 23, +18)

- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Tool coverage: unverified → 100

### 2026-07-31 (score 5, −20)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 25, −18)

- [security regression] Malware scan: pass → unverified

### 2026-07-27 (score 43)

First indexed and scored.

## MCP tools (4)

### `tavily_search` (~416 tokens)

Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.

Input parameters:

- `country` (string): Boost search results from a specific country. This will prioritize content from the selected country in the search results. Available only if topic is general.
- `end_date` (string): Will return all results before the specified end date. Required to be written in the format YYYY-MM-DD
- `exclude_domains` (array): List of domains to specifically exclude, if the user asks to exclude a domain set this to the domain of the site
- `include_domains` (array): A list of domains to specifically include in the search results, if the user asks to search on specific sites set this to the domain of the site
- `include_favicon` (boolean): Whether to include the favicon URL for each result
- `include_image_descriptions` (boolean): Include a list of query-related images and their descriptions in the response
- `include_images` (boolean): Include a list of query-related images in the response
- `include_raw_content` (boolean): Include the cleaned and parsed HTML content of each search result
- `max_results` (number): The maximum number of search results to return
- `query` (string, required): Search query
- `search_depth` (string): The depth of the search. 'basic' for generic results, 'advanced' for more thorough search, 'fast' for optimized low latency with high relevance, 'ultra-fast' for prioritizing latency above all else
- `start_date` (string): Will return all results after the specified start date. Required to be written in the format YYYY-MM-DD.
- `time_range` (string): The time range back from the current date to include in the search results. This feature is available for both 'general' and 'news' search topics
- `topic` (string): The category of the search. This will determine which of our agents will be used for the search

### `tavily_extract` (~110 tokens)

Extract content from URLs. Returns raw page content in markdown or text format.

Input parameters:

- `extract_depth` (string): Use 'advanced' for LinkedIn, protected sites, or tables/embedded content
- `format` (string): Output format
- `include_favicon` (boolean): Include favicon URLs
- `include_images` (boolean): Include images from pages
- `query` (string): Query to rerank content chunks by relevance
- `urls` (array, required): List of URLs to extract content from

### `tavily_crawl` (~290 tokens)

Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.

Input parameters:

- `allow_external` (boolean): Whether to return external links in the final response
- `extract_depth` (string): Advanced extraction retrieves more data, including tables and embedded content, with higher success but may increase latency
- `format` (string): The format of the extracted web page content. markdown returns content in markdown format. text returns plain text and may increase latency.
- `include_favicon` (boolean): Whether to include the favicon URL for each result
- `instructions` (string): Natural language instructions for the crawler. Instructions specify which types of pages the crawler should return.
- `limit` (integer): Total number of links the crawler will process before stopping
- `max_breadth` (integer): Max number of links to follow per level of the tree (i.e., per page)
- `max_depth` (integer): Max depth of the crawl. Defines how far from the base URL the crawler can explore.
- `select_domains` (array): Regex patterns to restrict crawling to specific domains or subdomains (e.g., ^docs\.example\.com$)
- `select_paths` (array): Regex patterns to select only URLs with specific path patterns (e.g., /docs/.*, /api/v1.*)
- `url` (string, required): The root URL to begin the crawl

### `tavily_map` (~201 tokens)

Map a website's structure. Returns a list of URLs found starting from the base URL.

Input parameters:

- `allow_external` (boolean): Whether to return external links in the final response
- `instructions` (string): Natural language instructions for the crawler
- `limit` (integer): Total number of links the crawler will process before stopping
- `max_breadth` (integer): Max number of links to follow per level of the tree (i.e., per page)
- `max_depth` (integer): Max depth of the mapping. Defines how far from the base URL the crawler can explore
- `select_domains` (array): Regex patterns to restrict crawling to specific domains or subdomains (e.g., ^docs\.example\.com$)
- `select_paths` (array): Regex patterns to select only URLs with specific path patterns (e.g., /docs/.*, /api/v1.*)
- `url` (string, required): The root URL to begin the mapping

## Diagnostics

Captured diagnostic sections: Provenance, Vulnerabilities, Dependencies. The full working is on the page: https://verifymcp.io/servers/tavily-ai-tavily-mcp/tavily-mcp#diagnostics

## Score history

- 2026-08-03: 60
- 2026-08-02: 59
- 2026-08-01: 23
- 2026-07-31: 5
- 2026-07-30: 25
- 2026-07-28: 43
- 2026-07-27: 43

## Links

- npm package: https://www.npmjs.com/package/tavily-mcp
- Socket report: https://socket.dev/npm/package/tavily-mcp
- Repository: https://github.com/tavily-ai/tavily-mcp
- Changelog RSS feed: https://verifymcp.io/servers/tavily-ai-tavily-mcp/tavily-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/tavily-ai-tavily-mcp/tavily-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/tavily-ai-tavily-mcp/tavily-mcp