Skip to main content
Glama
Polygon-io MCP Server

Polygon-io MCP Server

Official
by massive-com

[!IMPORTANT] :test_tube: Dieses Projekt ist experimentell und kann sich durch Breaking Changes ändern.

Massive.com MCP-Server

GitHub release

Ein Model Context Protocol (MCP)-Server, der Zugriff auf die vollständige Massive.com Finanzdaten-API über eine LLM-freundliche Schnittstelle bietet.

Anstatt ein Tool pro Endpunkt bereitzustellen, bietet dieser Server dem LLM drei kombinierbare Tools — search, call und query —, die die gesamte Massive.com API-Oberfläche abdecken. Daten können in einer In-Memory-SQLite-Datenbank gespeichert und mit integrierten Finanzfunktionen angereichert werden.

Tools

Tool

Beschreibung

search_endpoints

Suche nach API-Endpunkten und integrierten Funktionen per natürlichsprachlicher Abfrage. Gibt Titel, Pfad-Muster und Beschreibungen zurück. Setzen Sie detail auf "more" für Abfrageparameter-Dokumentation oder "verbose" für die vollständige Dokumentation. Verwenden Sie max_results, um die Ergebnisse zu begrenzen.

call_api

Ruft einen beliebigen Massive.com REST-API-Endpunkt auf. Unterstützt das Speichern von Ergebnissen als In-Memory-Datenbanktabelle (store_as) und die Anwendung von Nachbearbeitungsfunktionen (apply). Paginierte Antworten enthalten einen Hinweis auf die nächste Seite.

query_data

Führt SQL auf der gespeicherten SQLite-DB aus. Unterstützt SHOW TABLES, DESCRIBE <table>, DROP TABLE <table>, CTEs, Fensterfunktionen und mehr. Ergebnisse können ebenfalls mit apply nachbearbeitet werden.

Integrierte Funktionen

Funktionen können über den apply-Parameter bei call_api und query_data auf API-Ergebnisse oder Abfrageausgaben angewendet werden. Verwenden Sie search_endpoints mit scope="functions", um diese zu entdecken.

Kategorie

Funktionen

Greeks

bs_price, bs_delta, bs_gamma, bs_theta, bs_vega, bs_rho — Black-Scholes Optionspreismodell und Greeks

Renditen

simple_return, log_return, cumulative_return, sharpe_ratio, sortino_ratio

Technisch

sma (einfacher gleitender Durchschnitt), ema (exponentieller gleitender Durchschnitt)

Datenabdeckung

Der Server indiziert beim Start dynamisch alle Massive.com API-Endpunkte von llms.txt, sodass er automatisch mit der API synchron bleibt. Die Abdeckung umfasst:

  • Aktien-, Options-, Forex-, Krypto- und Futures-Aggregate

  • Echtzeit- und historische Trades und Kurse

  • Markt-Snapshots, Gewinner/Verlierer

  • Ticker-Details und Referenzdaten

  • Dividenden, Splits, IPOs

  • Finanzielle Fundamentaldaten

  • Analystenbewertungen und Nachrichten (Benzinga)

  • Staatsanleiherenditen, Inflationsdaten

  • Marktstatus und Feiertage

Related MCP server: market-data-mcp

Installation

Voraussetzungen

  • Python 3.12+

  • Ein Massive.com API-Schlüssel Button

  • Astral UV (v0.4.0+)

Claude Code

Installieren Sie zuerst Claude Code

npm install -g @anthropic-ai/claude-code

Installieren Sie den MCP-Server und registrieren Sie ihn dann bei Claude Code:

# Install the server (one-time — downloads dependencies ahead of time)
uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.10.0"

# Register with Claude Code
claude mcp add massive -e MASSIVE_API_KEY=your_api_key_here -- mcp_massive

Um später auf eine neue Version zu aktualisieren:

uv tool upgrade mcp_massive

[!NOTE] Upgrade von uvx oder uv run --with? Frühere Versionen empfahlen uvx --from ... mcp_massive oder uv run --with. Diese Befehle laden Abhängigkeiten bei jedem Kaltstart herunter, was dazu führen kann, dass der Server das 30-Sekunden-Verbindungstimeout von Claude überschreitet. Wechseln Sie zu uv tool install wie oben gezeigt — dies lädt Abhängigkeiten einmal herunter und startet danach sofort.

Dieser Befehl installiert den MCP-Server in Ihrem aktuellen Projekt. Wenn Sie ihn global installieren möchten, können Sie den Befehl mit dem Flag -s <scope> ausführen. Siehe claude mcp add --help für weitere Optionen.

Um Claude Code zu starten, führen Sie claude in Ihrem Terminal aus.

  • Wenn Sie es zum ersten Mal verwenden, folgen Sie den Einrichtungsanweisungen zur Authentifizierung

Sie können auch claude mcp add-from-claude-desktop ausführen, falls der MCP-Server bereits für Claude Desktop installiert ist.

Claude Desktop

  1. Befolgen Sie die Claude Desktop MCP-Installationsanweisungen, um die Erstinstallation abzuschließen und Ihre Konfigurationsdatei zu finden.

  2. Installieren Sie den Server:

uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.10.0"
  1. Suchen Sie den Pfad der installierten Binärdatei:

# Mac/Linux
which mcp_massive

# Windows
where mcp_massive
  1. Fügen Sie den Server zu Ihrer Claude Desktop-Konfiguration hinzu. Ersetzen Sie <path_to_mcp_massive> durch die Ausgabe des vorherigen Schritts und füllen Sie die verbleibenden Felder aus.

{
    "mcpServers": {
        "massive": {
            "command": "<path_to_mcp_massive>",
            "env": {
                "MASSIVE_API_KEY": "<your_api_key_here>",
                "HOME": "<your_home_directory>"
            }
        }
    }
}

Konfiguration

Umgebungsvariablen

Variable

Erforderlich

Standard

Beschreibung

MASSIVE_API_KEY

Ja

—

Ihr Massive.com API-Schlüssel

POLYGON_API_KEY

Nein

—

Veralteter Alias für MASSIVE_API_KEY

MCP_TRANSPORT

Nein

stdio

Transportprotokoll: stdio, sse oder streamable-http

MASSIVE_API_BASE_URL

Nein

https://api.massive.com

Basis-URL für API-Anfragen

MASSIVE_LLMS_TXT_URL

Nein

https://massive.com/docs/rest/llms.txt

URL für den Endpunkt-Index

MASSIVE_MAX_TABLES

Nein

50

Maximale Anzahl an In-Memory-Tabellen

MASSIVE_MAX_ROWS

Nein

50000

Maximale Zeilen pro gespeicherter Tabelle

Transport

Standardmäßig wird der STDIO-Transport verwendet. Der Transport kann über das CLI-Argument --transport oder die Umgebungsvariable MCP_TRANSPORT festgelegt werden (das CLI-Argument hat Vorrang).

# CLI argument
MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massive --transport streamable-http

# Environment variable
MCP_TRANSPORT=streamable-http MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massive

Anwendungsbeispiele

Sobald die Integration abgeschlossen ist, können Sie Claude auffordern, auf Massive.com-Daten zuzugreifen:

Get the latest price for AAPL stock
Show me yesterday's trading volume for MSFT
What were the biggest stock market gainers today?
Get me the latest crypto market data for BTC-USD
Calculate the 20-day SMA for AAPL closing prices over the last 3 months
Compute Black-Scholes delta for these option contracts

Entwicklung

Lokal ausführen

Stellen Sie sicher, dass Sie die Voraussetzungen installiert haben.

# Sync dependencies
uv sync

# Run the server
MASSIVE_API_KEY=your_api_key_here uv run mcp_massive

Installieren Sie aus Ihrem lokalen Checkout und referenzieren Sie dann die Binärdatei direkt:

uv tool install --force /path/to/mcp_massive
{
  "mcpServers": {
    "massive": {
      "command": "mcp_massive",
      "env": {
        "MASSIVE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Debugging

Für Debugging und Tests empfehlen wir die Verwendung des MCP Inspector:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp_massive run mcp_massive

Dies startet eine Browser-Oberfläche, in der Sie direkt mit Ihrem MCP-Server interagieren und Ein-/Ausgaben für jedes Tool sehen können.

Wählen Sie den Transporttyp STDIO in der Browser-UI mit dem Befehl uv und run mcp_massive als Argumente.

Code-Linting

Dieses Projekt verwendet just für allgemeine Entwicklungsaufgaben. Um Ihren Code vor dem Einreichen eines PR zu linten:

just lint

Dies führt ruff format und ruff check --fix aus, um Ihren Code automatisch zu formatieren und Linting-Probleme zu beheben.

Datenschutzrichtlinie

Dieser MCP-Server interagiert mit der API von Massive.com, um Marktdaten abzurufen. Alle Datenanfragen unterliegen der Datenschutzrichtlinie und den Nutzungsbedingungen von Massive.com.

  • Massive.com Datenschutzrichtlinie: https://massive.com/legal/privacy

  • Datenverarbeitung: Dieser Server speichert oder zwischenspeichert keine Benutzerdaten. Alle Anfragen werden direkt an die API von Massive.com weitergeleitet.

  • API-Schlüssel: Ihr Massive.com API-Schlüssel wird nur zur Authentifizierung von Anfragen an deren API verwendet.

  • User-Agent: API-Anfragen enthalten einen User-Agent-String, der die MCP-Serverversion enthält (z. B. MCP-Massive/0.x.y). Es werden keine personenbezogenen Daten übermittelt.

Mitwirken

Wenn Sie einen Fehler gefunden haben oder eine Idee für eine neue Funktion haben, diskutieren Sie diese bitte zuerst mit uns, indem Sie ein neues Issue einreichen. Wir werden innerhalb von maximal 3 Wochen auf Issues antworten. Wir sind auch offen für Freiwillige, wenn Sie einen PR für offene Issues einreichen möchten, aber bitte besprechen Sie dies vorher mit uns. PRs, die nicht mit einem bestehenden Issue verknüpft sind oder nicht vorab mit uns besprochen wurden, werden in der Regel abgelehnt.

Available Tools

53 tools
get_aggsC

List aggregate bars for a ticker over a given date range in custom time window sizes.

Inputs: from_ (required), multiplier (required), ticker (required), timespan (required), +5 more.

get_daily_open_close_aggC

Get daily open, close, high, and low for a specific ticker and date.

Inputs: date (required), ticker (required), adjusted, params.

get_exchangesC

List exchanges known by Polygon.io.

Inputs: asset_class, locale, params.

get_futures_contract_detailsC

Get details for a single futures contract at a specified point in time.

Inputs: ticker (required), as_of, params.

get_futures_product_detailsC

Get details for a single futures product as it was at a specific day.

Inputs: product_code (required), as_of, params, type.

get_futures_snapshotD

Get snapshots for futures contracts.

Inputs: limit, params, product_code, product_code_any_of, +11 more.

get_grouped_daily_aggsC

Get grouped daily bars for entire market for a specific date.

Inputs: date (required), adjusted, include_otc, locale, +2 more.

get_last_crypto_tradeC

Get the most recent trade for a crypto pair.

Inputs: from_ (required), to (required), params.

get_last_forex_quoteC

Get the most recent forex quote.

Inputs: from_ (required), to (required), params.

get_last_quoteC

Get the most recent quote for a ticker symbol.

Inputs: ticker (required), params.

get_last_tradeC

Get the most recent trade for a ticker symbol.

Inputs: ticker (required), params.

get_market_holidaysC

Get upcoming market holidays and their open/close times.

Inputs: params.

get_market_statusC

Get current trading status of exchanges and financial markets.

Inputs: params.

get_previous_close_aggC

Get previous day's open, close, high, and low for a specific ticker.

Inputs: ticker (required), adjusted, params.

get_real_time_currency_conversionC

Get real-time currency conversion.

Inputs: from_ (required), to (required), amount, params, +1 more.

get_snapshot_allC

Get a snapshot of all tickers in a market.

Inputs: market_type (required), include_otc, params, tickers.

get_snapshot_crypto_bookC

Get snapshot for a crypto ticker's order book.

Inputs: ticker (required), params.

get_snapshot_directionD

Get gainers or losers for a market.

Inputs: direction (required), market_type (required), include_otc, params.

get_snapshot_optionC

Get snapshot for a specific option contract.

Inputs: option_contract (required), underlying_asset (required), params.

get_snapshot_tickerC

Get snapshot for a specific ticker.

Inputs: market_type (required), ticker (required), params.

get_ticker_detailsC

Get detailed information about a specific ticker.

Inputs: ticker (required), date, params.

get_ticker_typesC

List all ticker types supported by Polygon.io.

Inputs: asset_class, locale, params.

list_aggsC

Iterate through aggregate bars for a ticker over a given date range.

Inputs: from_ (required), multiplier (required), ticker (required), timespan (required), +5 more.

list_benzinga_analyst_insightsD

List Benzinga analyst insights.

Inputs: benzinga_firm_id, benzinga_firm_id_any_of, benzinga_firm_id_gt, benzinga_firm_id_gte, +41 more.

list_benzinga_analystsD

List Benzinga analysts.

Inputs: benzinga_firm_id, benzinga_firm_id_any_of, benzinga_firm_id_gt, benzinga_firm_id_gte, +23 more.

list_benzinga_consensus_ratingsC

List Benzinga consensus ratings for a ticker.

Inputs: ticker (required), date, date_gt, date_gte, +4 more.

list_benzinga_earningsD

List Benzinga earnings.

Inputs: date, date_any_of, date_gt, date_gte, +53 more.

list_benzinga_firmsD

List Benzinga firms.

Inputs: benzinga_id, benzinga_id_any_of, benzinga_id_gt, benzinga_id_gte, +5 more.

list_benzinga_guidanceD

List Benzinga guidance.

Inputs: date, date_any_of, date_gt, date_gte, +41 more.

list_benzinga_newsD

List Benzinga news.

Inputs: author, author_any_of, author_gt, author_gte, +26 more.

list_benzinga_ratingsD

List Benzinga ratings.

Inputs: benzinga_analyst_id, benzinga_analyst_id_any_of, benzinga_analyst_id_gt, benzinga_analyst_id_gte, +53 more.

list_conditionsD

List conditions used by Polygon.io.

Inputs: asset_class, data_type, id, params, +1 more.

list_dividendsC

Get historical cash dividends.

Inputs: dividend_type, ex_dividend_date, frequency, limit, +2 more.

list_futures_aggregatesC

Get aggregates for a futures contract in a given time range.

Inputs: resolution (required), ticker (required), limit, params, +6 more.

list_futures_contractsC

Get a paginated list of futures contracts.

Inputs: active, as_of, first_trade_date, last_trade_date, +5 more.

list_futures_market_statusesC

Get market statuses for futures products.

Inputs: limit, params, product_code, product_code_any_of, +1 more.

list_futures_productsC

Get a list of futures products (including combos).

Inputs: as_of, asset_class, asset_sub_class, limit, +8 more.

list_futures_quotesC

Get quotes for a futures contract in a given time range.

Inputs: ticker (required), limit, params, session_end_date, +10 more.

list_futures_schedulesC

Get trading schedules for multiple futures products on a specific date.

Inputs: limit, params, session_end_date, sort, +1 more.

list_futures_schedules_by_product_codeC

Get schedule data for a single futures product across many trading dates.

Inputs: product_code (required), limit, params, session_end_date, +5 more.

list_futures_tradesC

Get trades for a futures contract in a given time range.

Inputs: ticker (required), limit, params, session_end_date, +10 more.

list_inflationC

Get inflation data from the Federal Reserve.

Inputs: date, date_any_of, date_gt, date_gte, +5 more.

list_iposC

Retrieve upcoming or historical IPOs.

Inputs: ipo_status, limit, listing_date, listing_date_gt, +7 more.

list_quotesC

Get quotes for a ticker symbol.

Inputs: ticker (required), limit, order, params, +6 more.

list_short_interestC

Retrieve short interest data for stocks.

Inputs: limit, order, params, settlement_date, +6 more.

list_short_volumeC

Retrieve short volume data for stocks.

Inputs: date, date_gt, date_gte, date_lt, +6 more.

list_splitsC

Get historical stock splits.

Inputs: execution_date, limit, params, reverse_split, +1 more.

list_stock_financialsC

Get fundamental financial data for companies.

Inputs: cik, company_name, company_name_search, filing_date, +17 more.

list_ticker_newsC

Get recent news articles for a stock ticker.

Inputs: limit, order, params, published_utc, +2 more.

list_tickersC

Query supported ticker symbols across stocks, indices, forex, and crypto.

Inputs: active, cik, cusip, date, +9 more.

list_tradesC

Get trades for a ticker symbol.

Inputs: ticker (required), limit, order, params, +6 more.

list_treasury_yieldsD

Retrieve treasury yield data.

Inputs: date, date_any_of, date_gt, date_gte, +6 more.

list_universal_snapshotsC

Get universal snapshots for multiple assets of a specific type.

Inputs: type (required), limit, order, params, +2 more.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    C2.5/5.0

    Scored across 53 tools

    Disambiguation4/5

    Most tools have distinct purposes targeting specific asset classes (e.g., stocks, crypto, futures) or data types (e.g., aggregates, snapshots, lists), with clear boundaries. However, some overlap exists between similar 'list' and 'get' functions (e.g., list_aggs vs get_aggs) that could cause minor confusion, though descriptions help differentiate them.

    Naming Consistency5/5

    Tool names follow a highly consistent verb_noun pattern throughout, using 'get_' for single-item retrieval and 'list_' for collections, with clear and descriptive nouns (e.g., get_ticker_details, list_futures_contracts). There are no deviations in naming conventions, making the set predictable and readable.

    Tool Count2/5

    With 53 tools, the count is excessive for a single server, making it overwhelming and difficult for agents to navigate efficiently. While the domain (financial data) is broad, this many tools suggests poor scoping and could lead to usability issues, as typical well-scoped servers have 3-15 tools.

    Completeness5/5

    The tool surface provides comprehensive coverage for financial data retrieval, including stocks, crypto, forex, futures, and market metadata, with full CRUD-like operations (mostly read/list functions) and no apparent gaps. It supports diverse workflows from real-time quotes to historical analysis and auxiliary data like news or holidays.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Real-time financial market data MCP server. Stocks, crypto, technicals, sentiment, FDA calendar. No API keys required.
      -
    • F
      license
      A
      quality
      D
      maintenance
      Extensible trading-intelligence MCP server with diagnostic tools, structured logging, and tool registration; currently provides server info tool with plans for market data adapters.
      1
      -