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