Skip to content
Back to search

tavily-mcp

Production ready MCP server with real-time search, extract, map & crawl.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/tavily-ai/tavily-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/tavily-ai/tavily-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tavily-ai--tavily-mcp/badge.svg)](/listings/tavily-ai--tavily-mcp)

HTML

<a href="/listings/tavily-ai--tavily-mcp"><img src="/api/listings/tavily-ai--tavily-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**A. Using MCP Inspector:**

* Open the MCP Inspector and click "Open Auth Settings". * Select the OAuth flow and complete these steps: 1. Metadata discovery 2. Client registration 3. Preparing authorization 4. Request authorization and obtain the authorization code 5. Token request 6. Authentication complete

Once finished, you will receive an access token that lets you securely make authenticated requests to the Tavily Remote MCP server.

**B. Using other MCP Clients (Example: Cursor):**

You can configure your MCP client to use OAuth without including your Tavily API key in the URL. For example, in your `mcp.json`:

{
  "mcpServers": {
    "tavily-remote-mcp": {
      "command": "npx mcp-remote https://mcp.tavily.com/mcp",
      "env": {}
    }
  }
}

If you need to clear stored OAuth credentials and reauthenticate, run:

rm -rf ~/.mcp-auth

> **Note:** > - OAuth authentication is optional. You can still use API key authentication at any time by including your Tavily API key in the URL query parameter (`?tavilyApiKey=...`) or by setting it in the `Authorization` header, as described above.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 235 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Tavily MCP Server
  2. ![GitHub Repo stars](https://img.shields.io/github/stars/tavily-ai/tavily-mcp?style=social)
  3. ![npm](https://img.shields.io/npm/dt/tavily-mcp)
  4. ![smithery badge](https://smithery.ai/badge/@tavily-ai/tavily-mcp)
  5. The Tavily MCP server provides:
  6. - search, extract, map, crawl tools
  7. - Real-time web search capabilities through the tavily-search tool
  8. - Intelligent data extraction from web pages via the tavily-extract tool
  9. - Powerful web mapping tool that creates a structured map of website
  10. - Web crawler that systematically explores websites
  11. ### 📚 Helpful Resources
  12. - [Tutorial](https://medium.com/@dustin_36183/building-a-knowledge-graph-assistant-combining-tavily-and-neo4j-mcp-servers-with-claude-db92de075df9) on combining Tavily MCP with Neo4j MCP server
  13. - [Tutorial](https://medium.com/@dustin_36183/connect-your-coding-assistant-to-the-web-integrating-tavily-mcp-with-cline-in-vs-code-5f923a4983d1) on integrating Tavily MCP with Cline in VS Code
  14. ## Remote MCP Server
  15. Connect directly to Tavily's remote MCP server instead of running it locally. This provides a seamless experience without requiring local installation or configuration.
  16. Simply use the remote MCP server URL with your Tavily API key:
  17. ```
  18. https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>
  19. ```
  20. Get your Tavily API key from [tavily.com](https://www.tavily.com/).
  21. Alternatively, you can pass your API key through an Authorization header if the MCP client supports this:
  22. ```
  23. Authorization: Bearer <your-api-key>
  24. ```
  25. **Note:** When using the remote MCP, you can specify default parameters for all requests by including a `DEFAULT_PARAMETERS` header containing a JSON object with your desired defaults. Example:
  26. ```json
  27. {"include_images":true, "search_depth": "basic", "max_results": 10}
  28. ```
  29. ## Connect to Claude Code
  30. [Claude Code](https://docs.anthropic.com/en/docs/claude-code) is Anthropic's official CLI tool for Claude. You can add the Tavily MCP server using the `claude mcp add` command. There are two ways to authenticate:
  31. #### Option 1: API Key in URL
  32. Pass your API key directly in the URL. Replace `<your-api-key>` with your actual [Tavily API key](https://www.tavily.com/):
  33. ```bash
  34. claude mcp add --transport http tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>
  35. ```
  36. #### Option 2: OAuth Authentication Flow
  37. Add the server without an API key in the URL:
  38. ```bash
  39. claude mcp add --transport http tavily https://mcp.tavily.com/mcp
  40. ```
  41. After adding, you'll need to complete the authentication flow:
  42. 1. Run `claude` to start Claude Code
  43. 2. Type `/mcp` to open the MCP server management
  44. 3. Select the Tavily server and complete the authentication process
  45. **Tip:** Add `--scope user` to either command to make the Tavily MCP server available globally across all your projects:
  46. ```bash
  47. claude mcp add --transport http --scope user tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>
  48. ```
  49. Once configured, you'll have access to the Tavily search, extract, map, and crawl tools.
  50. ## Connect to Cursor
  51. [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=tavily-remote-mcp&config=eyJjb21tYW5kIjoibnB4IC15IG1jcC1yZW1vdGUgaHR0cHM6Ly9tY3AudGF2aWx5LmNvbS9tY3AvP3RhdmlseUFwaUtleT08eW91ci1hcGkta2V5PiIsImVudiI6e319)
  52. Click the ⬆️ Add to Cursor ⬆️ button, this will do most of the work for you but you will still need to edit the configuration to add your API-KEY. You can get a Tavily API key [here](https://www.tavily.com/).
  53. once you click the button you should be redirect to Cursor ...
  54. ### Step 1
  55. Click the install button
  56. ![](assets/cursor-step1.png)
  57. ### Step 2
  58. You should see the MCP is now installed, if the blue slide is not already turned on, manually turn it on. You also need to edit the configuration to include your own Tavily API key.
  59. ![](assets/cursor-step2.png)
  60. ### Step 3
  61. You will then be redirected to your `mcp.json` file where you have to add `your-api-key`.
  62. ```json
  63. {
  64. "mcpServers": {
  65. "tavily-remote-mcp": {
  66. "command": "npx -y mcp-remote https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>",
  67. "env": {}
  68. }
  69. }
  70. }
  71. ```
  72. ### Remote MCP Server OAuth Flow
  73. The Tavily Remote MCP server supports secure OAuth authentication, allowing you to connect and authorize seamlessly with compatible clients.
  74. #### How to Set Up OAuth Authentication
  75. **A. Using MCP Inspector:**
  76. * Open the MCP Inspector and click "Open Auth Settings".
  77. * Select the OAuth flow and complete these steps:
  78. 1. Metadata discovery
  79. 2. Client registration
  80. 3. Preparing authorization
  81. 4. Request authorization and obtain the authorization code
  82. 5. Token request
  83. 6. Authentication complete
  84. Once finished, you will receive an access token that lets you securely make authenticated requests to the Tavily Remote MCP server.
  85. **B. Using other MCP Clients (Example: Cursor):**
  86. You can configure your MCP client to use OAuth without including your Tavily API key in the URL. For example, in your `mcp.json`:
  87. ```json
  88. {
  89. "mcpServers": {
  90. "tavily-remote-mcp": {
  91. "command": "npx mcp-remote https://mcp.tavily.com/mcp",
  92. "env": {}
  93. }
  94. }
  95. }
  96. ```
  97. If you need to clear stored OAuth credentials and reauthenticate, run:
  98. ```bash
  99. rm -rf ~/.mcp-auth
  100. ```
  101. > **Note:**
  102. > - OAuth authentication is optional. You can still use API key authentication at any time by including your Tavily API key in the URL query parameter (`?tavilyApiKey=...`) or by setting it in the `Authorization` header, as described above.
  103. #### Choosing an Account for OAuth
  104. Each time you connect, Tavily asks whether to use your personal account or one of your organizations. To switch Tavily logins, choose **Use a different account**.
  105. - **Key used**: the account's `mcp_auth_default` key. Tavily creates it if it doesn't exist.
  106. - **Organization keys**: used even if another member created the key or your organization restricts key access.
  107. - **Personal accounts off**: if an organization you belong to disables personal accounts, Personal isn't offered.
  108. - **Lost access**: if you lose access to the account or its key is deleted, requests fail and ask you to reconnect. Tavily never switches accounts on its own.
  109. ## Local MCP
  110. ### Prerequisites 🔧
  111. Before you begin, ensure you have:
  112. - [Tavily API key](https://app.tavily.com/home)
  113. - If you don't have a Tavily API key, you can sign up for a free account [here](https://app.tavily.com/home)
  114. - [Claude Desktop](https://claude.ai/download) or [Cursor](https://cursor.sh)
  115. - [Node.js](https://nodejs.org/) (v20 or higher)
  116. - You can verify your Node.js installation by running:
  117. - `node --version`
  118. - [Git](https://git-scm.com/downloads) installed (only needed if using Git installation method)
  119. - On macOS: `brew install git`
  120. - On Linux:
  121. - Debian/Ubuntu: `sudo apt install git`
  122. - RedHat/CentOS: `sudo yum install git`
  123. - On Windows: Download [Git for Windows](https://git-scm.com/download/win)
  124. ### Running with NPX
  125. ```bash
  126. npx -y tavily-mcp@latest
  127. ```
  128. ## Default Parameters Configuration ⚙️
  129. You can set default parameter values for the `tavily-search` tool using the `DEFAULT_PARAMETERS` environment variable. This allows you to configure default search behavior without specifying these parameters in every request.
  130. ### Example Configuration
  131. ```bash
  132. export DEFAULT_PARAMETERS='{"include_images": true}'
  133. ```
  134. ### Example usage from Client
  135. ```json
  136. {
  137. "mcpServers": {
  138. "tavily-mcp": {
  139. "command": "npx",
  140. "args": ["-y", "tavily-mcp@latest"],
  141. "env": {
  142. "TAVILY_API_KEY": "your-api-key-here",
  143. "DEFAULT_PARAMETERS": "{\"include_images\": true, \"max_results\": 15, \"search_depth\": \"advanced\"}"
  144. }
  145. }
  146. }
  147. }
  148. ```
  149. ## Identifying the End User (Optional)
  150. You can optionally identify the end user on whose behalf requests are being made by setting the `TAVILY_HUMAN_ID` environment variable. When set, Tavily MCP forwards it as the `X-Human-Id` header on every API call, enabling per-user analytics.
  151. This is **entirely optional** — leave it unset and behavior is unchanged.
  152. ```json
  153. {
  154. "mcpServers": {
  155. "tavily-mcp": {
  156. "command": "npx",
  157. "args": ["-y", "tavily-mcp@latest"],
  158. "env": {
  159. "TAVILY_API_KEY": "your-api-key-here",
  160. "TAVILY_HUMAN_ID": "your-user-id"
  161. }
  162. }
  163. }
  164. }
  165. ```
  166. **Privacy note:** Tavily hashes `human_id` server-side (SHA-256) before storage, so the raw value is never persisted. Even so, prefer opaque identifiers (e.g. an internal user ID) over raw PII like emails when possible.
  167. ## Acknowledgments ✨
  168. - [Model Context Protocol](https://modelcontextprotocol.io) for the MCP specification
  169. - [Anthropic](https://anthropic.com) for Claude Desktop

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.