pairbook-mcp

Servidor MCP y CLI para PairBook, el motor de correlación y solapamiento de ETF que cubre más de 4.700 acciones y ETF de EE. UU. Cualquiera de los 11,3 millones de pares posibles puede compararse: 52.000+ pares populares vienen precalculados con solapamiento de carteras procedente de los emisores, y cualquier otra combinación se calcula bajo demanda a partir de series de rendimientos semanales. La API JSON subyacente es gratuita y estática, no requiere clave y se actualiza cada día de negociación tras el cierre de EE. UU.

Pregúntale a tu asistente de IA cosas como «¿está mi cartera demasiado concentrada?», «¿qué correlación hay entre QQQ y VOO, y cuánto se solapan?» o «encuentra diversificadores para NVDA» y podrá responder con cifras recientes y con fuentes en lugar de adivinar.

Configuración de MCP

Claude Code

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

Cursor: instalación con un clic con

Claude Desktop: añade esto a claude_desktop_config.json:

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

Cualquier otro cliente MCP funciona de la misma manera: ejecuta npx -y pairbook-mcp mediante stdio.

Related MCP server: TickerAPI

Herramientas

Análisis de cartera

Pásale una cartera completa (de 2 a 30 posiciones, pesos opcionales) y te dirá qué posiciones son redundantes, dónde se concentra el riesgo, qué diversifica de verdad y si los ETF que tienes se solapan internamente:

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

La herramienta MCP analyze_portfolio devuelve el mismo análisis como JSON estructurado: contribuciones de riesgo de Euler, ratio de diversificación y apuestas de riesgo independientes, bloques de correlación que se mueven juntos, drawdown frente a SPY y avisos de solapamiento procedentes de los emisores entre los ETF mantenidos (que QQQ y VOO compartan el 53.5% de las mismas acciones es algo que ninguna otra herramienta de carteras informa). Cada fórmula está documentada en docs/methodology.md, los invariantes están cubiertos por pruebas, y nada es una previsión ni un consejo.

CLI

Los mismos datos en tu terminal, sin necesidad de instalar nada:

npx -y -p pairbook-mcp pairbook QQQ VOO

o después de 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

Códigos de salida: 0 en caso de éxito, 1 ante cualquier error (los errores van a stderr). --json imprime un documento JSON válido en stdout, de modo que pairbook qqq voo --json | jq .correlation_weekly funciona directamente.

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/

Alcance

PairBook es un especialista: correlación, solapamiento y estructura de diversificación. Combina bien con un servidor MCP general de datos de mercado que aporte cotizaciones, fundamentales y noticias, así que instala ambos y deja que tu asistente los combine.

Datos

Todo proviene de la API de PairBook gratuita: correlaciones calculadas sobre rendimientos semanales (ventanas de 1/3/5 años), solapamiento a partir de las divulgaciones de cartera de los emisores, recalculado cada día de negociación. El conjunto de datos también se publica como descargas CSV con un DOI.

Gratuito con atribución (un enlace de vuelta a pairbook.io). Solo acciones y ETF cotizados en EE. UU. Nada de esto es asesoramiento de inversión.

Privacidad

El servidor y la CLI se ejecutan íntegramente en tu máquina y son de solo lectura. Llaman a un único host (www.pairbook.io) para obtener datos públicos de mercado, se identifican con una versión y una cadena de superficie en el user agent, y no envían nada más: ni prompts, ni contenido de conversaciones, ni datos personales, ni telemetría. Política completa: pairbook.io/privacy.

Licencia

MIT © VoidLab