Tavily Mcp Sse

Tavily MCP Server

Basic FastAPI-based server application that provides endpoints for interacting with the Tavily API. The server includes API key authentication and uses the fastapi-mcp library to create a remote SSE MCP server out of it.

Installation

To install the project's dependencies, run the following command:

pip install -r requirements.txt

Usage

To run the server, use the following command:

uvicorn server:app --host 0.0.0.0 --port 8000 --reload

The server will be available at http://127.0.0.1:8000.

API Key

The server requires two API keys:

• API_KEY: The API key for accessing the server's endpoints.
• TAVILY_API_KEY: The API key for accessing the Tavily API.

Set these API keys as environment variables before running the server.

Endpoints

/tavily-search

Perform a search using the Tavily API.

• Method: POST
• Request Body: TavilySearchRequest
• query (str): The search query.
• search_depth (Literal["basic", "advanced"], optional): The depth of the search. Defaults to "basic".
• topic (Literal["general", "news"], optional): The topic of the search. Defaults to "general".
• days (int, optional): The number of days to search. Defaults to 3.
• time_range (Literal["day", "week", "month", "year", "d", "w", "m", "y"], optional): The time range of the search. Defaults to "day".
• max_results (int, optional): The maximum number of results to return. Defaults to 10.
• include_images (bool, optional): Whether to include images in the results. Defaults to False.
• include_image_descriptions (bool, optional): Whether to include image descriptions in the results. Defaults to False.
• include_raw_content (bool, optional): Whether to include raw content in the results. Defaults to False.
• include_domains (list[str], optional): A list of domains to include in the search. Defaults to an empty list.
• exclude_domains (list[str], optional): A list of domains to exclude from the search. Defaults to an empty list.
• Response: TavilyResponse

/tavily-extract

Extract content from URLs using the Tavily API.

• Method: POST
• Request Body: TavilyExtractRequest
• urls (list[str]): A list of URLs to extract content from.
• extract_depth (Literal["basic", "advanced"], optional): The depth of the extraction. Defaults to "basic".
• include_images (bool, optional): Whether to include images in the extraction. Defaults to False.
• Response: TavilyResponse

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: NoeSamaille
• Source: NoeSamaille/tavily-mcp-sse
• License: MIT

Install and usage instructions live in the source repository linked above.