pairbook-mcp

PairBook 用のMCPサーバーとCLIです。これは、4,700以上の米国株とETFをカバーする相関・ETFオーバーラップエンジンです。全1,130万組のペアを比較できます: 52,000以上の人気ペアは、発行体ソースの保有オーバーラップ付きで事前計算されており、それ以外のすべての組み合わせは週次リターン系列からオンデマンドで計算されます。基盤となるJSON APIは無料で静的で、キーは不要、米国市場の終了後に毎取引日更新されます。

AIアシスタントに 「ポートフォリオが集中しすぎている？」、「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ツール analyzte_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 はstdoutに1つの有効なJSON文書を出力するので、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年ウィンドウ）で計算された相関、発行体のポートフォリオ開示によるオーバーラップ、毎取引日ごとに再計算されます。このデータセットは、DOI付きの CSVダウンロード としても公開されています。

帰属表示付きで無料です（pairbook.io へのリンク）。米国上場の銘柄とETFのみ。ここに記載されている内容は投資助言ではありません。

プライバシー

サーバーとCLIは完全にお使いのマシン上で動作し、読み取り専用です。公開市場データを取得するために単一のホスト（www.pairbook.io）にアクセスし、ユーザーエージェント内のバージョンとサーフェス文字列で身元を示しますが、それ以外は何も送信しません: プロンプトも会話内容も個人データもテレメトリもありません。完全なポリシー: pairbook.io/privacy。

ライセンス

MIT © VoidLab