Skip to main content
Glama
Polygon-io MCP Server

Polygon-io MCP Server

Official
by massive-com

[!IMPORTANT] :test_tube: このプロジェクトは実験的なものであり、破壊的な変更が行われる可能性があります。

Massive.com MCP サーバー

GitHub release

Model Context Protocol (MCP) サーバーであり、LLMフレンドリーなインターフェースを通じて、完全な Massive.com 金融データAPIへのアクセスを提供します。

このサーバーは、エンドポイントごとに1つのツールを公開するのではなく、search(検索)、call(呼び出し)、query(クエリ)という3つの構成可能なツールをLLMに提供し、Massive.com APIの全範囲をカバーします。データはインメモリのSQLiteデータベースに保存でき、組み込みの金融関数で強化することも可能です。

ツール

ツール

説明

search_endpoints

自然言語クエリでAPIエンドポイントと組み込み関数を検索します。タイトル、パスパターン、説明を返します。クエリパラメータのドキュメントを表示するには detail を "more" に、完全なドキュメントを表示するには "verbose" に設定してください。結果を制限するには max_results を使用します。

call_api

Massive.com REST APIエンドポイントを呼び出します。結果をインメモリデータベーステーブルとして保存 (store_as) し、後処理関数 (apply) を適用することをサポートしています。ページネーションされたレスポンスには、次のページへのヒントが含まれます。

query_data

保存されたSQLite DBに対してSQLを実行します。SHOW TABLES、DESCRIBE <table>、DROP TABLE <table>、CTE、ウィンドウ関数などをサポートしています。結果は apply を使用して後処理することも可能です。

組み込み関数

関数は、call_api および query_data の apply パラメータを介して、API結果やクエリ出力に適用できます。関数を検索するには、scope="functions" を指定して search_endpoints を使用してください。

カテゴリ

関数

Greeks

bs_price, bs_delta, bs_gamma, bs_theta, bs_vega, bs_rho — ブラック・ショールズ・オプション価格計算およびグリークス

Returns

simple_return, log_return, cumulative_return, sharpe_ratio, sortino_ratio

Technical

sma (単純移動平均), ema (指数平滑移動平均)

データカバレッジ

このサーバーは、起動時に llms.txt からすべての Massive.com API エンドポイントを動的にインデックス化するため、APIと自動的に同期されます。カバレッジには以下が含まれます:

  • 株式、オプション、FX、暗号資産、先物のアグリゲート

  • リアルタイムおよび過去の取引とクォート

  • 市場スナップショット、上昇/下落銘柄

  • ティッカー詳細および参照データ

  • 配当、株式分割、IPO

  • 財務ファンダメンタルズ

  • アナリスト評価およびニュース (Benzinga)

  • 国債利回り、インフレデータ

  • 市場ステータスおよび休日

Related MCP server: market-data-mcp

インストール

前提条件

  • Python 3.12+

  • Massive.com APIキー Button

  • Astral UV (v0.4.0+)

Claude Code

まず、Claude Code をインストールします。

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

MCPサーバーをインストールし、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

後で新しいバージョンにアップグレードするには:

uv tool upgrade mcp_massive

[!NOTE] uvx または uv run --with からのアップグレードですか? 以前のバージョンでは uvx --from ... mcp_massive や uv run --with が推奨されていました。これらのコマンドはコールドスタートのたびに依存関係をダウンロードするため、Claudeの30秒の接続タイムアウトを超える可能性があります。上記のように uv tool install に切り替えてください。一度依存関係をダウンロードすれば、その後は即座に起動します。

このコマンドは、現在のプロジェクトにMCPサーバーをインストールします。 グローバルにインストールしたい場合は、-s <scope> フラグを付けてコマンドを実行できます。 その他のオプションについては claude mcp add --help を参照してください。

Claude Codeを起動するには、ターミナルで claude を実行します。

  • 初めて使用する場合は、セットアップのプロンプトに従って認証を行ってください。

すでにClaude Desktop用にMCPサーバーがインストールされている場合は、claude mcp add-from-claude-desktop を実行することもできます。

Claude Desktop

  1. Claude Desktop MCPインストール手順 に従って、初期インストールを完了し、設定ファイルを見つけます。

  2. サーバーをインストールします:

uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.10.0"
  1. インストールされたバイナリパスを見つけます:

# Mac/Linux
which mcp_massive

# Windows
where mcp_massive
  1. Claude Desktopの設定にサーバーを追加します。<path_to_mcp_massive> を前のステップの出力に置き換え、残りのフィールドを埋めます。

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

設定

環境変数

変数

必須

デフォルト

説明

MASSIVE_API_KEY

はい

—

Massive.com APIキー

POLYGON_API_KEY

いいえ

—

MASSIVE_API_KEY の非推奨エイリアス

MCP_TRANSPORT

いいえ

stdio

トランスポートプロトコル: stdio, sse, または streamable-http

MASSIVE_API_BASE_URL

いいえ

https://api.massive.com

APIリクエストのベースURL

MASSIVE_LLMS_TXT_URL

いいえ

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

エンドポイントインデックスのURL

MASSIVE_MAX_TABLES

いいえ

50

インメモリテーブルの最大数

MASSIVE_MAX_ROWS

いいえ

50000

保存されたテーブルごとの最大行数

トランスポート

デフォルトではSTDIOトランスポートが使用されます。トランスポートは --transport CLI引数または MCP_TRANSPORT 環境変数で設定できます(CLI引数が優先されます)。

# 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

使用例

統合が完了すると、ClaudeにMassive.comのデータにアクセスするよう指示できます:

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

開発

ローカルでの実行

前提条件 がインストールされていることを確認してください。

# Sync dependencies
uv sync

# Run the server
MASSIVE_API_KEY=your_api_key_here uv run mcp_massive

ローカルのチェックアウトからインストールし、バイナリを直接参照します:

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

デバッグ

デバッグとテストには、MCP Inspector の使用を推奨します:

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

これにより、ブラウザインターフェースが起動し、MCPサーバーと直接対話して各ツールの入出力を確認できます。

ブラウザUIで STDIO トランスポートタイプを選択し、引数として uv と run mcp_massive を指定してください。

コードのリンティング

このプロジェクトでは、一般的な開発タスクに just を使用しています。PRを提出する前にコードをリントするには:

just lint

これにより ruff format と ruff check --fix が実行され、コードが自動的にフォーマットされ、リンティングの問題が修正されます。

リンク

プライバシーポリシー

このMCPサーバーは、Massive.comのAPIと対話して市場データを取得します。すべてのデータリクエストは、Massive.comのプライバシーポリシーおよび利用規約に従います。

  • Massive.com プライバシーポリシー: https://massive.com/legal/privacy

  • データ処理: このサーバーはユーザーデータを保存またはキャッシュしません。すべてのリクエストはMassive.comのAPIに直接プロキシされます。

  • APIキー: Massive.com APIキーは、APIへのリクエストを認証するためにのみ使用されます。

  • User-Agent: APIリクエストには、MCPサーバーのバージョン(例: MCP-Massive/0.x.y)を含むUser-Agent文字列が含まれます。個人を特定できる情報は含まれません。

貢献

バグを見つけた場合や新機能のアイデアがある場合は、まず新しいIssueを提出して私たちと議論してください。 Issueには最大3週間以内に回答します。 オープンなIssueに対してPRを提出したいボランティアも歓迎しますが、事前に私たちと議論してください。 既存のIssueにリンクされていない、または事前に議論されていないPRは、原則として拒否されます。

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
      -