Tavily Web Search MCP Server
Provides tools for interacting with the Polygon API to access financial market data and services
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Tavily Web Search MCP Server find recent news about AI advancements in healthcare"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
AI Makerspace: MCP Session Repo for Session 13
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 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.uvwinget 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://AI-Maker-Space/AIE8-MCP-Session.gitAfter that, you can follow from Step 2. below!
Installation
Clone the repository:
git clone <repository-url> cd <repository-directory>Configure environment variables: Copy the
.env.sampleto.envand add your Tavily API key:TAVILY_API_KEY=your_api_key_here🏗️ 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.
Activities:
There are a few activities for this assignment!
🏗️ Activity #1:
Choose an API that you enjoy using - and build an MCP server for it!
Answer: I am implementing polygon API tool in this MCP server.
🏗️ Activity #2:
Build a simple LangGraph application that interacts with your MCP Server.
You can find details here!
Answer: langgraph_agent.py file has been implemented for this.
Available Tools
3 toolsget_stock_ohlcA
Get Open, High, Low, Close (OHLC) data for a stock symbol for the last working day or specified date
Inputs: symbol (required), date. Returns: result
roll_diceC
Roll the dice with the given notation
Inputs: notation (required), num_rolls. Returns: result
web_searchC
Search the web for information about the given query
Inputs: query (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a completely distinct purpose with no overlap: get_stock_ohlc retrieves financial data, roll_dice performs a random number generation game, and web_search conducts internet queries. The domains are so different that an agent would never confuse them.
The naming is inconsistent with mixed conventions: get_stock_ohlc uses snake_case with a verb_noun pattern, roll_dice uses snake_case but with a verb-only style, and web_search uses snake_case with a noun_verb pattern. There is no predictable naming scheme across the set.
With only 3 tools, the server feels too thin for its apparent scope as a 'Tavily Web Search MCP Server'—web_search aligns with this, but get_stock_ohlc and roll_dice are unrelated utilities that don't fit cohesively. The count is low and the tools lack a unified domain focus.
For a web search server, the surface is severely incomplete: web_search covers basic queries, but there are no tools for advanced search features (e.g., filtering, pagination, or result analysis). The inclusion of unrelated tools like get_stock_ohlc and roll_dice creates gaps in the core domain without adding meaningful coverage.
Maintenance
Related MCP Connectors
Web search, scraping, Google Trends and data lookups. Paid per call in USDC on Base via x402.
Web data for agents. Extract web pages, crawl websites, discover URLs, and search the web.
Web search, scraping, crawling, research, a browser agent, and company and people data.
Web search, point-in-time crypto market data, verified strategy track records and 160+ agent tools.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceProvides AI-powered web search capabilities using Tavily's search API, enabling LLMs to perform sophisticated web searches, get direct answers to questions, and search recent news articles.72MIT
- AlicenseNot gradedqualityFmaintenanceEnables AI assistants to perform up-to-date web searches through the Tavily API, providing comprehensive search results with AI-generated summaries.7MIT
- FlicenseCqualityDmaintenanceEnables web search capabilities through the Tavily API, allowing users to perform web searches and retrieve information from the internet through natural language queries.3-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to perform real-time web searches, extract data from web pages, map website structures, and crawl websites using the Tavily API.74 npmMIT