pairbook-mcp

MCP-сервер и CLI для PairBook — движка корреляций и пересечений ETF, охватывающего более 4 700 американских акций и ETF. Любую из 11,3 миллиона возможных пар можно сравнить: более 52 000 популярных пар предрассчитаны с пересечением составов от эмитентов, а любая другая комбинация вычисляется по запросу на основе недельных рядов доходности. Базовый JSON API бесплатен и статичен, не требует ключа и обновляется каждый торговый день после закрытия американского рынка.

Спросите вашего ИИ-ассистента, например: «не слишком ли сконцентрирован мой портфель?», «насколько коррелированы QQQ и VOO, и как сильно они пересекаются?» или «найди мне диверсификаторы для NVDA» — и он ответит свежими числами из источников, а не догадками.

Настройка MCP

Claude Code

claude mcp add pairbook -- npx -y pairbook-mcp

Cursor: установка в один клик с помощью

Claude Desktop: добавьте это в claude_desktop_config.json:

{
  "mcpServers": {
    "pairbook": {
      "command": "npx",
      "args": ["-y", "pairbook-mcp"]
    }
  }
}

Любой другой MCP-клиент работает так же: запустите npx -y pairbook-mcp через stdio.

Related MCP server: TickerAPI

Инструменты

Анализ портфеля

Передайте ему целый портфель (от 2 до 30 позиций, веса опциональны) — и он расскажет, какие позиции избыточны, где концентрируется риск, что действительно диверсифицирует и не пересекаются ли ваши ETF под капотом:

pairbook portfolio AAPL:25 MSFT:25 NVDA:20 JNJ:15 XOM:15

RISK
  volatility     16.7%  (weighted average of the parts: 29.0%)
  beta vs SPY    0.99    market explains 73% of the moves (R2)
  max drawdown   -17.4%  (2024-12-05 to 2025-04-03, SPY: -16.9%)

RISK BUDGET  (share of portfolio risk vs share of capital)
  NVDA   ############  43.1% risk     20% capital  beta 2.18  risk engine  <- 20% of the capital but 43% of the risk
  AAPL   ########      27.1% risk     25% capital  beta 1.06  diversifier
  ...

MCP-инструмент analyze_portfolio возвращает тот же анализ в виде структурированного JSON: вклад в риск по Эйлеру, коэффициент диверсификации и независимые рисковые ставки, корреляционные блоки, которые движутся вместе, просадка относительно SPY и предупреждения о пересечении составов от эмитентов между удерживаемыми ETF (то, что QQQ и VOO держат 53,5% одних и тех же акций, не сообщает ни один другой портфельный инструмент). Каждая формула задокументирована в docs/methodology.md, инварианты покрыты тестами, и ничто здесь не является прогнозом или советом.

CLI

Те же данные в вашем терминале, без установки:

npx -y -p pairbook-mcp pairbook QQQ VOO

или после npm i -g pairbook-mcp:

pairbook QQQ VOO         # compare two assets
pairbook NVDA            # one asset's profile
pairbook search nvidia   # find a ticker
pairbook AAPL MSFT --json

Коды выхода: 0 при успехе, 1 при любой ошибке (ошибки идут в stderr). --json выводит один корректный JSON-документ в stdout, так что pairbook qqq voo --json | jq .correlation_weekly просто работает.

DGRO vs SCHD  (data as of 2026-08-27)
  correlation   1y 0.74   3y 0.88   5y 0.93
  beta vs SPY   DGRO 0.65   SCHD 0.52
  volatility    DGRO 11.4%   SCHD 12.9%
  overlap       20.8% across 32 common holdings (issuer files 2026-08-26)
  https://www.pairbook.io/pair/dgro-vs-schd/

Область применения

PairBook — специалист: корреляция, пересечения и структура диверсификации. Он хорошо сочетается с универсальным MCP-сервером рыночных данных, который предоставляет котировки, фундаментальные показатели и новости, так что установите оба и позвольте вашему ассистенту комбинировать их.

Данные

Все данные поступают из бесплатного PairBook API: корреляции, рассчитанные по недельной доходности (окна 1/3/5 лет), пересечения из раскрытий портфелей эмитентов, пересчитываются каждый торговый день. Набор данных также публикуется в виде CSV-загрузок с DOI.

Бесплатно с указанием авторства (ссылка на pairbook.io). Только акции и ETF, торгуемые в США. Ничто здесь не является инвестиционной рекомендацией.

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

Сервер и CLI полностью выполняются на вашей машине и доступны только для чтения. Они обращаются к одному хосту (www.pairbook.io) для получения публичных рыночных данных, идентифицируют себя строкой версии и surface в user agent и больше ничего не отправляют: ни промптов, ни содержимого переписки, ни персональных данных, ни телеметрии. Полная политика: pairbook.io/privacy.

Лицензия

MIT © VoidLab