Skip to main content
Glama
Polygon-io MCP Server

Polygon-io MCP Server

Official
by massive-com

[!IMPORTANT] :test_tube: Этот проект является экспериментальным и может подвергаться критическим изменениям.

MCP-сервер Massive.com

GitHub release

Сервер Model Context Protocol (MCP), предоставляющий доступ к полному API финансовых данных Massive.com через интерфейс, удобный для LLM.

Вместо того чтобы предоставлять по одному инструменту на каждую конечную точку, этот сервер дает LLM три компонуемых инструмента — search (поиск), call (вызов) и query (запрос), — которые охватывают всю поверхность API Massive.com. Данные могут храниться в оперативной базе данных SQLite и дополняться встроенными финансовыми функциями.

Инструменты

Инструмент

Описание

search_endpoints

Поиск конечных точек API и встроенных функций с помощью запроса на естественном языке. Возвращает заголовки, шаблоны путей и описания. Установите detail в значение "more" для получения документации по параметрам запроса или "verbose" для полной документации. Используйте max_results для ограничения количества результатов.

call_api

Вызов любой конечной точки REST API Massive.com. Поддерживает сохранение результатов в виде таблицы базы данных в оперативной памяти (store_as) и применение функций постобработки (apply). Пагинированные ответы включают подсказку для следующей страницы.

query_data

Выполнение SQL-запросов к сохраненной базе данных SQLite. Поддерживает SHOW TABLES, DESCRIBE <table>, DROP TABLE <table>, CTE, оконные функции и многое другое. Результаты также могут быть обработаны с помощью apply.

Встроенные функции

Функции могут применяться к результатам API или выводу запросов через параметр apply в call_api и query_data. Используйте search_endpoints с scope="functions" для их обнаружения.

Категория

Функции

Греки

bs_price, bs_delta, bs_gamma, bs_theta, bs_vega, bs_rho — ценообразование опционов по Блэку-Шоулзу и греки

Доходность

simple_return, log_return, cumulative_return, sharpe_ratio, sortino_ratio

Технические

sma (простое скользящее среднее), ema (экспоненциальное скользящее среднее)

Покрытие данных

Сервер динамически индексирует все конечные точки API Massive.com при запуске из llms.txt, поэтому он автоматически остается синхронизированным с API. Покрытие включает:

  • Агрегаты акций, опционов, форекс, криптовалют и фьючерсов

  • Торги и котировки в реальном времени и исторические данные

  • Рыночные сводки, лидеры роста/падения

  • Детали тикеров и справочные данные

  • Дивиденды, сплиты, IPO

  • Финансовые фундаментальные показатели

  • Рейтинги аналитиков и новости (Benzinga)

  • Доходность казначейских облигаций, данные об инфляции

  • Статус рынка и праздничные дни

Related MCP server: market-data-mcp

Установка

Предварительные требования

  • Python 3.12+

  • API-ключ Massive.com 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. Эти команды загружают зависимости при каждом «холодном» запуске, что может привести к превышению 30-секундного тайм-аута соединения Claude. Перейдите на uv tool install, как показано выше — это загружает зависимости один раз и после этого запускается мгновенно.

Эта команда установит MCP-сервер в ваш текущий проект. Если вы хотите установить его глобально, вы можете запустить команду с флагом -s <scope>. Смотрите claude mcp add --help для получения дополнительных опций.

Чтобы запустить Claude Code, введите claude в терминале.

  • Если вы используете его впервые, следуйте подсказкам настройки для аутентификации

Вы также можете запустить claude mcp add-from-claude-desktop, если MCP-сервер уже установлен для 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

Да

—

Ваш API-ключ Massive.com

POLYGON_API_KEY

Нет

—

Устаревший псевдоним для MASSIVE_API_KEY

MCP_TRANSPORT

Нет

stdio

Транспортный протокол: stdio, sse или streamable-http

MASSIVE_API_BASE_URL

Нет

https://api.massive.com

Базовый URL для запросов API

MASSIVE_LLMS_TXT_URL

Нет

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

URL для индекса конечных точек

MASSIVE_MAX_TABLES

Нет

50

Максимальное количество таблиц в оперативной памяти

MASSIVE_MAX_ROWS

Нет

50000

Максимальное количество строк на сохраненную таблицу

Транспорт

По умолчанию используется транспорт STDIO. Транспорт можно задать через аргумент CLI --transport или переменную окружения 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-сервером и видеть ввод/вывод для каждого инструмента.

Выберите тип транспорта STDIO в пользовательском интерфейсе браузера с аргументами uv и run mcp_massive.

Линтинг кода

Этот проект использует just для общих задач разработки. Чтобы проверить код перед отправкой PR:

just lint

Это запустит ruff format и ruff check --fix для автоматического форматирования кода и исправления проблем линтинга.

Ссылки

Политика конфиденциальности

Этот MCP-сервер взаимодействует с API Massive.com для получения рыночных данных. Все запросы данных регулируются политикой конфиденциальности и условиями обслуживания Massive.com.

  • Политика конфиденциальности Massive.com: https://massive.com/legal/privacy

  • Обработка данных: Этот сервер не хранит и не кэширует пользовательские данные. Все запросы проксируются напрямую к API Massive.com.

  • API-ключ: Ваш API-ключ Massive.com используется только для аутентификации запросов к их API.

  • User-Agent: Запросы API включают строку User-Agent, содержащую версию MCP-сервера (например, MCP-Massive/0.x.y). Никакая личная информация не включается.

Участие в разработке

Если вы нашли ошибку или у вас есть идея для новой функции, пожалуйста, сначала обсудите ее с нами, создав новый issue. Мы ответим на вопросы в течение максимум 3 недель. Мы также открыты для волонтеров, если вы хотите отправить PR для любых открытых задач, но, пожалуйста, обсудите это с нами заранее. PR, которые не связаны с существующим issue или не обсуждались с нами заранее, как правило, будут отклонены.

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
      -