Tekventedor/polygon-mcp-server

Polygon Market Data MCP Server

A Model Context Protocol (MCP) server that provides real-time market data through the Polygon.io API. This server enables Claude Desktop and other MCP clients to access comprehensive stock market information.

Features

• Real-time Stock Quotes - Get current prices, volume, and change metrics
• Market Status - Check if markets are open/closed
• Stock Search - Find stocks by ticker symbol or company name
• News Feed - Latest news articles for any stock
• Historical Data - Price aggregates for technical analysis

Demo

Installation

1. Clone this repository:

git clone https://github.com/YOUR_USERNAME/polygon-mcp-server.git
cd polygon-mcp-server

2. Install dependencies:

pip install -r requirements.txt

3. Set up your API key:

# Edit .env and replace with your Polygon API key
nano .env  # or open in any text editor

Get your free API key from Polygon.io

Two Server Implementations

This repository provides two different MCP server implementations:

1. server.py - Uses the official MCP Python SDK (recommended)
2. server_fastmcp.py - Uses the FastMCP framework (alternative)

Both servers provide identical functionality, choose based on your preference.

Configuration for Claude Desktop

Add this to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Option 1: Using MCP SDK (Recommended)

{
  "mcpServers": {
    "polygon-market-data": {
      "command": "python",
      "args": ["/path/to/polygon-mcp-server/server.py"],
      "env": {
        "POLYGON_API_KEY": "your_polygon_api_key_here"
      }
    }
  }
}

Option 2: Using FastMCP

{
  "mcpServers": {
    "polygon-market-data": {
      "command": "python",
      "args": ["/path/to/polygon-mcp-server/server_fastmcp.py"],
      "env": {
        "POLYGON_API_KEY": "your_polygon_api_key_here"
      }
    }
  }
}

Available Tools

get_stock_quote

Get real-time quote for any stock symbol

get_stock_quote(symbol="AAPL")

get_market_status

Check current market hours and status

get_market_status()

search_stocks

Search for stocks by ticker or company name

search_stocks(query="Tesla", limit=5)

get_stock_news

Get latest news articles for a stock

get_stock_news(symbol="TSLA", limit=10)

get_aggregates

Get historical price data

get_aggregates(symbol="GOOGL", timespan="day", from_date="2024-01-01", to_date="2024-01-31")

Development

Using MCP SDK Server:

python server.py

Using FastMCP Server:

python server_fastmcp.py

Test with FastMCP Inspector:

fastmcp dev server_fastmcp.py

Requirements

• Python 3.8+
• Polygon.io API key (free tier available)
• Dependencies listed in requirements.txt

Custom MCP Server Development

We develop MCP Servers for customers, if you need MCP server for your own system similar to Polygon MCP server, please contact us (https://www.flowhunt.io/contact/). Here is the description how we develop MCP Servers for our customers: https://www.flowhunt.io/services/mcp-server-development/

License

MIT License - See LICENSE file for details

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

For issues and questions, please use the GitHub Issues page.