tavily-mcp-sse

tavily-mcp-sse

3.2

If you are the rightful owner of tavily-mcp-sse and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Tavily MCP Server is a FastAPI-based server application that provides endpoints for interacting with the Tavily API, featuring API key authentication and remote SSE MCP server capabilities.

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