polygon-mcp-server

jwaresolutions/polygon-mcp-server

3.2

If you are the rightful owner of polygon-mcp-server 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.

The Polygon MCP Server is a Model Context Protocol server designed to facilitate interaction with the Polygon.io API for accessing market data.

Tools
8
Resources
0
Prompts
0

Polygon MCP Server

A Model Context Protocol (MCP) server that provides tools for interacting with the Polygon.io API for market data.

Features

This MCP server provides the following tools:

  • get_ticker_details - Get details about a ticker symbol
  • get_latest_quote - Get real-time quote for a ticker
  • get_aggregates - Get aggregate bars for a ticker
  • get_daily_open_close - Get daily open/close prices
  • get_market_status - Check if markets are open
  • get_ticker_news - Get news articles for a ticker
  • list_tickers - Search/list available tickers
  • get_snapshot - Get snapshot of ticker(s)

Installation

  1. Clone this repository
  2. Install dependencies: 
    npm install
  3. Build the server: 
    npm run build

Configuration

The server requires the following environment variable:

  • POLYGON_API_KEY - Your Polygon.io API key

MCP Settings Configuration

Add the following to your MCP settings file:

{
  "mcpServers": {
    "polygon": {
      "command": "node",
      "args": ["/path/to/polygon-server/build/index.js"],
      "env": {
        "POLYGON_API_KEY": "your-api-key"
      }
    }
  }
}

Usage Examples

Get Market Status

{
  "tool": "get_market_status",
  "arguments": {}
}

Get Ticker Details

{
  "tool": "get_ticker_details",
  "arguments": {
    "ticker": "AAPL"
  }
}

Get Historical Data

{
  "tool": "get_aggregates",
  "arguments": {
    "ticker": "AAPL",
    "timespan": "day",
    "from": "2024-01-01",
    "to": "2024-01-31"
  }
}

Get News

{
  "tool": "get_ticker_news",
  "arguments": {
    "ticker": "TSLA",
    "limit": 5
  }
}

Development

  • Run in watch mode: npm run watch
  • Run tests: npm test
  • Lint code: npm run lint

API Documentation

For more information about the Polygon.io API, visit: https://polygon.io/docs

License

MIT