[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-78602":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":27,"readmeContent":28,"aiSummary":29,"trendingCount":16,"starSnapshotCount":16,"syncStatus":30,"lastSyncTime":31,"discoverSource":32},78602,"tavily-mcp","tavily-ai\u002Ftavily-mcp","tavily-ai","Production ready MCP server with real-time search, extract, map & crawl.","",null,"JavaScript",2084,269,6,24,0,13,35,82,39,29.29,"MIT License",false,"main",true,[],"2026-06-12 02:03:47","# Tavily MCP Server\n![GitHub Repo stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Ftavily-ai\u002Ftavily-mcp?style=social)\n![npm](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdt\u002Ftavily-mcp)\n![smithery badge](https:\u002F\u002Fsmithery.ai\u002Fbadge\u002F@tavily-ai\u002Ftavily-mcp)\n\nThe Tavily MCP server provides:\n- search, extract, map, crawl tools\n- Real-time web search capabilities through the tavily-search tool\n- Intelligent data extraction from web pages via the tavily-extract tool\n- Powerful web mapping tool that creates a structured map of website \n- Web crawler that systematically explores websites \n\n\n### 📚 Helpful Resources\n- [Tutorial](https:\u002F\u002Fmedium.com\u002F@dustin_36183\u002Fbuilding-a-knowledge-graph-assistant-combining-tavily-and-neo4j-mcp-servers-with-claude-db92de075df9) on combining Tavily MCP with Neo4j MCP server\n- [Tutorial](https:\u002F\u002Fmedium.com\u002F@dustin_36183\u002Fconnect-your-coding-assistant-to-the-web-integrating-tavily-mcp-with-cline-in-vs-code-5f923a4983d1) on integrating Tavily MCP with Cline in VS Code\n\n## Remote MCP Server\n\nConnect directly to Tavily's remote MCP server instead of running it locally. This provides a seamless experience without requiring local installation or configuration.\n\nSimply use the remote MCP server URL with your Tavily API key:\n\n``` \nhttps:\u002F\u002Fmcp.tavily.com\u002Fmcp\u002F?tavilyApiKey=\u003Cyour-api-key> \n```\n Get your Tavily API key from [tavily.com](https:\u002F\u002Fwww.tavily.com\u002F).\n\nAlternatively, you can pass your API key through an Authorization header if the MCP client supports this:\n\n```\nAuthorization: Bearer \u003Cyour-api-key>\n```\n**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:\n\n\n```json\n{\"include_images\":true, \"search_depth\": \"basic\", \"max_results\": 10}\n```\n\n## Connect to Claude Code\n\n[Claude Code](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-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:\n\n#### Option 1: API Key in URL\n\nPass your API key directly in the URL. Replace `\u003Cyour-api-key>` with your actual [Tavily API key](https:\u002F\u002Fwww.tavily.com\u002F):\n\n```bash\nclaude mcp add --transport http tavily https:\u002F\u002Fmcp.tavily.com\u002Fmcp\u002F?tavilyApiKey=\u003Cyour-api-key>\n```\n\n#### Option 2: OAuth Authentication Flow\n\nAdd the server without an API key in the URL:\n\n```bash\nclaude mcp add --transport http tavily https:\u002F\u002Fmcp.tavily.com\u002Fmcp\n```\n\nAfter adding, you'll need to complete the authentication flow:\n1. Run `claude` to start Claude Code\n2. Type `\u002Fmcp` to open the MCP server management\n3. Select the Tavily server and complete the authentication process\n\n**Tip:** Add `--scope user` to either command to make the Tavily MCP server available globally across all your projects:\n\n```bash\nclaude mcp add --transport http --scope user tavily https:\u002F\u002Fmcp.tavily.com\u002Fmcp\u002F?tavilyApiKey=\u003Cyour-api-key>\n```\n\nOnce configured, you'll have access to the Tavily search, extract, map, and crawl tools.\n\n## Connect to Cursor\n[![Install MCP Server](https:\u002F\u002Fcursor.com\u002Fdeeplink\u002Fmcp-install-dark.svg)](https:\u002F\u002Fcursor.com\u002Fen\u002Finstall-mcp?name=tavily-remote-mcp&config=eyJjb21tYW5kIjoibnB4IC15IG1jcC1yZW1vdGUgaHR0cHM6Ly9tY3AudGF2aWx5LmNvbS9tY3AvP3RhdmlseUFwaUtleT08eW91ci1hcGkta2V5PiIsImVudiI6e319)\n\nClick 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:\u002F\u002Fwww.tavily.com\u002F).\n\n\nonce you click the button you should be redirect to Cursor ...\n\n### Step 1\nClick the install button\n\n![](assets\u002Fcursor-step1.png)\n\n\n### Step 2\nYou 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.\n![](assets\u002Fcursor-step2.png)\n\n### Step 3\nYou will then be redirected to your `mcp.json` file where you have to add `your-api-key`.\n\n```json\n{\n  \"mcpServers\": {\n    \"tavily-remote-mcp\": {\n      \"command\": \"npx -y mcp-remote https:\u002F\u002Fmcp.tavily.com\u002Fmcp\u002F?tavilyApiKey=\u003Cyour-api-key>\",\n      \"env\": {}\n    }\n  }\n}\n```\n\n### Remote MCP Server OAuth Flow\n\nThe Tavily Remote MCP server supports secure OAuth authentication, allowing you to connect and authorize seamlessly with compatible clients.\n\n#### How to Set Up OAuth Authentication\n\n**A. Using MCP Inspector:**\n\n* Open the MCP Inspector and click \"Open Auth Settings\".\n* Select the OAuth flow and complete these steps:\n   1. Metadata discovery\n   2. Client registration\n   3. Preparing authorization\n   4. Request authorization and obtain the authorization code\n   5. Token request\n   6. Authentication complete\n\nOnce finished, you will receive an access token that lets you securely make authenticated requests to the Tavily Remote MCP server.\n\n**B. Using other MCP Clients (Example: Cursor):**\n\nYou can configure your MCP client to use OAuth without including your Tavily API key in the URL. For example, in your `mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"tavily-remote-mcp\": {\n      \"command\": \"npx mcp-remote https:\u002F\u002Fmcp.tavily.com\u002Fmcp\",\n      \"env\": {}\n    }\n  }\n}\n```\n\nIf you need to clear stored OAuth credentials and reauthenticate, run:\n\n```bash\nrm -rf ~\u002F.mcp-auth\n```\n\n> **Note:**\n> - 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.\n\n#### Selecting Which API Key Is Used for OAuth\n\nAfter successful OAuth authentication, you can control which API key is used by naming it `mcp_auth_default`:\n\n- If you set a key named `mcp_auth_default` in your **personal account**, that key will be used for the auth flow.\n- If you are part of a **team** that has a key named `mcp_auth_default`, that key will be used for the auth flow.\n- If you have **both** a personal key and a team key named `mcp_auth_default`, the **personal key will be prioritized**.\n- If no `mcp_auth_default` key is set, the `default` key in your personal account will be used. If no `default` key is set, the first available key will be used.\n\n## Local MCP \n\n### Prerequisites 🔧\n\nBefore you begin, ensure you have:\n\n- [Tavily API key](https:\u002F\u002Fapp.tavily.com\u002Fhome)\n  - If you don't have a Tavily API key, you can sign up for a free account [here](https:\u002F\u002Fapp.tavily.com\u002Fhome)\n- [Claude Desktop](https:\u002F\u002Fclaude.ai\u002Fdownload) or [Cursor](https:\u002F\u002Fcursor.sh)\n- [Node.js](https:\u002F\u002Fnodejs.org\u002F) (v20 or higher)\n  - You can verify your Node.js installation by running:\n    - `node --version`\n- [Git](https:\u002F\u002Fgit-scm.com\u002Fdownloads) installed (only needed if using Git installation method)\n  - On macOS: `brew install git`\n  - On Linux: \n    - Debian\u002FUbuntu: `sudo apt install git`\n    - RedHat\u002FCentOS: `sudo yum install git`\n  - On Windows: Download [Git for Windows](https:\u002F\u002Fgit-scm.com\u002Fdownload\u002Fwin)\n\n### Running with NPX \n\n```bash\nnpx -y tavily-mcp@latest \n```\n\n## Default Parameters Configuration ⚙️\n\nYou 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.\n\n### Example Configuration\n\n```bash\nexport DEFAULT_PARAMETERS='{\"include_images\": true}'\n```\n\n### Example usage from Client\n```json\n{\n  \"mcpServers\": {\n    \"tavily-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"tavily-mcp@latest\"],\n      \"env\": {\n        \"TAVILY_API_KEY\": \"your-api-key-here\",\n        \"DEFAULT_PARAMETERS\": \"{\\\"include_images\\\": true, \\\"max_results\\\": 15, \\\"search_depth\\\": \\\"advanced\\\"}\"\n      }\n    }\n  }\n}\n```\n\n## Identifying the End User (Optional)\n\nYou 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.\n\nThis is **entirely optional** — leave it unset and behavior is unchanged.\n\n```json\n{\n  \"mcpServers\": {\n    \"tavily-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"tavily-mcp@latest\"],\n      \"env\": {\n        \"TAVILY_API_KEY\": \"your-api-key-here\",\n        \"TAVILY_HUMAN_ID\": \"your-user-id\"\n      }\n    }\n  }\n}\n```\n\n**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.\n\n## Acknowledgments ✨\n\n- [Model Context Protocol](https:\u002F\u002Fmodelcontextprotocol.io) for the MCP specification\n- [Anthropic](https:\u002F\u002Fanthropic.com) for Claude Desktop\n","Tavily MCP 服务器提供了一套集成了实时搜索、数据提取、网站映射和网页爬取的工具。其核心功能包括通过tavily-search实现的实时网络搜索能力，利用tavily-extract进行智能网页数据抓取，以及强大的网站结构化映射与系统性探索工具。该项目采用JavaScript编写，具有高度可扩展性和灵活性。适用于需要从互联网上快速获取并处理信息的应用场景，如构建知识图谱助手或集成到开发环境中的代码辅助工具等。用户可以选择直接连接到远程MCP服务器来简化配置过程，只需使用API密钥即可轻松访问服务。",2,"2026-06-11 03:56:58","high_star"]