pairbook-mcp

MCP-Server und CLI für PairBook, die Korrelations- und ETF-Überschneidungs-Engine, die 4.700+ US-Aktien und ETFs abdeckt. Jedes der 11,3 Millionen möglichen Paare kann verglichen werden: 52.000+ beliebte Paare sind vorberechnet mit Bestandsüberschneidungen aus Emittentenangaben, und jede andere Kombination wird bei Bedarf aus wöchentlichen Renditeserien berechnet. Die zugrunde liegende JSON-API ist kostenlos und statisch, benötigt keinen Schlüssel und wird an jedem Handelstag nach dem US-Börsenschluss aktualisiert.

Bitten Sie Ihren KI-Assistenten um Dinge wie „Ist mein Portfolio zu konzentriert?“, „Wie stark sind QQQ und VOO korreliert und wie stark überschneiden sie sich?“ oder „Finde mir Diversifikatoren für NVDA“, und er kann mit aktuellen, belegten Zahlen antworten, statt zu raten.

MCP-Einrichtung

Claude Code

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

Cursor: Ein-Klick-Installation mit

Claude Desktop: Fügen Sie dies zu claude_desktop_config.json hinzu:

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

Jeder andere MCP-Client funktioniert auf die gleiche Weise: Führen Sie npx -y pairbook-mcp über stdio aus.

Related MCP server: TickerAPI

Werkzeuge

Portfolioanalyse

Geben Sie ihm ein ganzes Portfolio (2 bis 30 Positionen, Gewichte optional) und es sagt Ihnen, welche Positionen redundant sind, wo sich das Risiko konzentriert, was tatsächlich diversifiziert und ob die von Ihnen gehaltenen ETFs im Hintergrund Überschneidungen aufweisen:

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
  ...

Das MCP-Tool analyze_portfolio liefert dieselbe Analyse als strukturiertes JSON: Euler-Risikobeiträge, Diversifikationsquote und unabhängige Risikowetten, Korrelationsblöcke, die sich gemeinsam bewegen, Drawdown vs. SPY und Überschneidungswarnungen aus Emittentenangaben zwischen den gehaltenen ETFs (dass QQQ und VOO 53,5 % derselben Aktien halten, berichtet kein anderes Portfolio-Tool). Jede Formel ist in docs/methodology.md dokumentiert, Invarianten sind durch Tests abgedeckt, und nichts davon ist eine Prognose oder Empfehlung.

CLI

Dieselben Daten in Ihrem Terminal, keine Installation erforderlich:

npx -y -p pairbook-mcp pairbook QQQ VOO

oder nach 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

Exit-Codes: 0 bei Erfolg, 1 bei jedem Fehler (Fehler gehen an stderr). --json gibt ein gültiges JSON-Dokument auf stdout aus, sodass pairbook qqq voo --json | jq .correlation_weekly einfach funktioniert.

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/

Umfang

PairBook ist ein Spezialist: Korrelation, Überschneidung und Diversifikationsstruktur. Es passt gut zu einem allgemeinen Marktdaten-MCP-Server, der Kurse, Fundamentaldaten und Nachrichten liefert. Installieren Sie also beide und lassen Sie Ihren Assistenten sie kombinieren.

Daten

Alles stammt aus der kostenlosen PairBook API: Korrelationen, berechnet auf wöchentlichen Renditen (1/3/5-Jahres-Fenster), Überschneidungen aus den Offenlegungen der Emittentenportfolios, neu berechnet an jedem Handelstag. Der Datensatz wird auch als CSV-Downloads mit einer DOI veröffentlicht.

Kostenlos mit Namensnennung (ein Link zurück zu pairbook.io). Nur in den USA notierte Aktien und ETFs. Nichts hiervon ist eine Anlageberatung.

Datenschutz

Der Server und die CLI laufen vollständig auf Ihrem Rechner und sind schreibgeschützt. Sie rufen einen einzigen Host (www.pairbook.io) auf, um öffentliche Marktdaten abzurufen, identifizieren sich mit einer Versions- und Oberflächenzeichenfolge im User-Agent und senden sonst nichts: keine Prompts, keine Gesprächsinhalte, keine persönlichen Daten, keine Telemetrie. Vollständige Richtlinie: pairbook.io/privacy.

Lizenz

MIT © VoidLab