Skip to main content
Glama
Tavily Web Search MCP Server

Tavily Web Search MCP Server

by terellcodes

AI Makerspace: MCP Event

This project is a demonstration of the MCP (Model Context Protocol) server, which utilizes the Tavily API for web search capabilities. The server is designed to run in a standard input/output (stdio) transport mode.

Related MCP server: Tavily Web Search MCP Server

Project Overview

The MCP server is set up to handle web search queries using the Tavily API. It is built with the following key components:

  • TavilyClient: A client for interacting with the Tavily API to perform web searches.

Prerequisites

  • Python 3.13 or higher

  • A valid Tavily API key

⚠️NOTE FOR WINDOWS:⚠️

You'll need to install this on the Windows side of your OS.

This will require getting two CLI tool for Powershell, which you can do as follows:

  • winget install astral-sh.uv

  • winget install --id Git.Git -e --source winget

After you have those CLI tools, please open Cursor into Windows.

Then, you can clone the repository using the following command in your Cursor terminal:

git clone https://github.com/AI-Maker-Space/MCP-Session-Code.git

After that, you can follow from Step 2. below!

Installation

  1. Clone the repository:

    git clone <repository-url>
    cd <repository-directory>
  2. Configure environment variables: Copy the .env.sample to .env and add your Tavily API key:

    TAVILY_API_KEY=your_api_key_here
  3. 🏗️ Add a new tool to your MCP Server 🏗️

Create a new tool in the server.py file, that's it!

Running the MCP Server

To start the MCP server, you will need to add the following to your MCP Profile in Cursor:

NOTE: To get to your MCP config. you can use the Command Pallete (CMD/CTRL+SHIFT+P) and select "View: Open MCP Settings" and replace the contents with the JSON blob below.

{
    "mcpServers":  {
        "mcp-server": {
            "command" : "uv",
            "args" : ["--directory", "/PATH/TO/REPOSITORY", "run", "server.py"]
        }
    }
}

The server will start and listen for commands via standard input/output.

Usage

The server provides a web_search tool that can be used to search the web for information about a given query. This is achieved by calling the web_search function with the desired query string.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Contributing

Contributions are welcome! Please open an issue or submit a pull request for any changes.

Available Tools

2 tools
check_stock_priceC

Get the current price of a stock symbol

Inputs: stock_symbol (required).

get_comprehensive_stock_dataC

Get comprehensive stock data including price, financial metrics, and recent news.

Inputs: stock_symbol (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.7/5.0

    Scored across 2 tools

    Disambiguation2/5

    The two tools have overlapping purposes, as both retrieve stock price data, with 'get_comprehensive_stock_data' including additional metrics and news. An agent could easily confuse them or misselect 'check_stock_price' when more comprehensive data is needed, leading to inefficiency or incomplete results.

    Naming Consistency3/5

    The tool names follow a mixed convention: 'check_stock_price' uses a verb_noun pattern, while 'get_comprehensive_stock_data' uses a verb_adjective_noun pattern. This inconsistency in naming styles (e.g., 'check' vs. 'get', and structure) reduces predictability, though the names are still readable and descriptive.

    Tool Count2/5

    With only 2 tools, the server feels under-scoped for a 'Tavily Web Search MCP Server', which suggests broader web search capabilities. The tools are narrowly focused on stock data, lacking general search or other domain-specific functions, making the count too low for the implied purpose.

    Completeness2/5

    The server has significant gaps in its tool surface. As a web search server, it lacks tools for general web searches, news retrieval, or other common search functions beyond stocks. The stock-related tools themselves are incomplete, missing operations like historical data, company info, or portfolio management, limiting agent effectiveness.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      D
      maintenance
      Enables web search capabilities through the Tavily API. Allows users to search the web for information using natural language queries via the MCP protocol.
      4
      1
      -
    • F
      license
      C
      quality
      D
      maintenance
      Enables web search capabilities through the Tavily API via the Model Context Protocol. Allows users to perform web searches and retrieve information from the internet through natural language queries.
      5
      -
    • F
      license
      C
      quality
      D
      maintenance
      Enables web search capabilities through the Tavily API. Allows users to search the web for information using natural language queries through the MCP protocol.
      3
      -