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