Tavily

by kshern

3 stars
1.6k downloads
Not rated
GitHub

About

Integrates with the Tavily API to enable advanced search and content extraction operations, facilitating web research and up-to-date information access for AI applications.

Details

Author
kshern
Repository
kshern/mcp-tavily
GitHub stars
3
Downloads
1,578
License
MIT License
Categories
Search, Other, API, Productivity, Developer Tools, Design, AI, Frontend
Tags
#integration, #web

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Tavily
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 @highlight/mcp-server

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "tavily": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "cmd"
}

A Model Context Protocol (MCP) server implementation for Tavily API, providing advanced search and content extraction capabilities.

- Multiple Search Tools:
- Content Extraction: Extract content from URLs with configurable options
- Rich Configuration Options: Extensive options for search depth, filtering, and content inclusion

Add the Tavily MCP server to your MCP configuration:

{ "mcpServers": { "tavily": { "command": "npx", "args": ["-y", "@mcptools/mcp-tavily"], "env": { "TAVILY_API_KEY": "your-api-key" } } } }

Note: Make sure to replaceyour-api-keywith your actual Tavily API key. You can also set it as an environment variableTAVILY_API_KEYbefore running the server.

The server provides three search tools that can be called through MCP:

// Tool name: search { query: "artificial intelligence", options: { searchDepth: "advanced", topic: "news", maxResults: 10 } }
// Tool name: searchContext { query: "latest developments in AI", options: { topic: "news", timeRange: "week" } }
// Tool name: searchQNA { query: "What is quantum computing?", options: { includeAnswer: true, maxResults: 5 } }
// Tool name: extract { urls: ["https://example.com/article1", "https://example.com/article2"], options: { extractDepth: "advanced", includeImages: true } }
interface SearchOptions { searchDepth?: "basic" | "advanced"; // Search depth level topic?: "general" | "news" | "finance"; // Search topic category days?: number; // Number of days to search maxResults?: number; // Maximum number of results includeImages?: boolean; // Include images in results includeImageDescriptions?: boolean; // Include image descriptions includeAnswer?: boolean; // Include answer in results includeRawContent?: boolean; // Include raw content includeDomains?: string[]; // List of domains to include excludeDomains?: string[]; // List of domains to exclude maxTokens?: number; // Maximum number of tokens timeRange?: "year" | "month" | "week" | "day" | "y" | "m" | "w" | "d"; // Time range for search }
interface ExtractOptions { extractDepth?: "basic" | "advanced"; // Extraction depth level includeImages?: boolean; // Include images in results }

All tools return responses in the following format:

{ content: Array<{ type: "text", text: string }> }

For extracted content, each item includes:

- URL
- Raw content
- Failed URLs list (if any)

All tools include proper error handling and will throw descriptive error messages if something goes wrong.

To install Tavily API Server for Claude Desktop automatically viaSmithery:

npx -y @smithery/cli install @kshern/mcp-tavily --client claude

- Node.js 16 or higher
- npm or yarn
- Tavily API key (get one from
Tavily)
- Clone the repository
- Install dependencies:

For development and debugging, we recommend usingMCP Inspector, a powerful development tool for MCP servers.

The Inspector provides a user interface for:

- Testing tool calls
- Viewing server responses
- Debugging tool execution
- Monitoring server state

Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (git checkout -b feature/AmazingFeature)
- Commit your changes (git commit -m 'Add some AmazingFeature')
- Push to the branch (git push origin feature/AmazingFeature)
- Open a Pull Request

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Search the web using Kagi's search API

Multi-provider search broker for AI agents. Routes across SearXNG, Brave, Serper, Tavily, and Exa with automatic fallback, RRF ranking, content extraction, and budget enforcement.

A search server for the Model Context Protocol (MCP) that uses the Baidu Wenxin API.

Perform web, news, and image searches using the Microsoft Bing Search API.

An MCP server for web and local search using the Brave Search API.

Integrates the Brave Search API for both web and local search capabilities. Requires a BRAVE_API_KEY.

An MCP server for the Brave Search API, providing web and local search capabilities via a streaming SSE interface.

An MCP server for the Brave Search API, providing both web and local search capabilities.

Search for cocktail recipes using the cezzis.com API.

Free search API for AI agents — 105 engines, 22 profiles, 94.3% SimpleQA accuracy, MCP server with 5 tools

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.