Market Intelligence MCP

Servidor Market Intelligence MCP

Probabilidad de recesión, rotación sectorial, posicionamiento institucional, análisis de escenarios de cascada macro, calculadoras inmobiliarias y datos económicos en tiempo real — para Claude, ChatGPT, Cursor y cualquier cliente MCP.

Impulsado por la API de BullrunData.

Inicio rápido (alojado — recomendado)

El endpoint alojado en https://bullrundata.com/api/mcp es la vía más rápida. Sin instalación, actualizaciones automáticas, y todos los clientes MCP a continuación lo soportan de forma nativa.

Obtén una clave API gratuita en bullrundata.com — 100 llamadas/día, sin tarjeta de crédito.

Claude Code

claude mcp add --transport http bullrundata https://bullrundata.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

Cursor

Añade a ~/.cursor/mcp.json (o al .cursor/mcp.json local del proyecto):

{
  "mcpServers": {
    "bullrundata": {
      "url": "https://bullrundata.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code

Añade a .vscode/mcp.json (espacio de trabajo) o a tu mcp.json de usuario:

{
  "servers": {
    "bullrundata": {
      "type": "http",
      "url": "https://bullrundata.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Windsurf

Añade a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "bullrundata": {
      "serverUrl": "https://bullrundata.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop

Claude Desktop aún no soporta HTTP MCP de forma nativa — haz un puente a través de mcp-remote. Añade a claude_desktop_config.json:

{
  "mcpServers": {
    "bullrundata": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://bullrundata.com/api/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

También puedes omitir el encabezado por completo — en la primera conexión, mcp-remote abre un flujo OAuth en tu navegador y aprovisiona automáticamente una clave de nivel gratuito.

{
  "mcpServers": {
    "market-intelligence": {
      "command": "npx",
      "args": ["-y", "@bullrundata/market-intelligence"],
      "env": {
        "BULLRUNDATA_API_KEY": "your-api-key"
      }
    }
  }
}

claude mcp add market-intelligence -- npx -y @bullrundata/market-intelligence

Herramientas disponibles

Inteligencia Macro

Mercados e Institucional

Calculadoras Inmobiliarias

Datos Económicos

Motor de Cascada (Análisis de Escenarios Macro)

Catalizadores disponibles: Shock de Oferta de Petróleo, Restricción de Liquidez del Dólar, Recorte de Emergencia de la Fed, Recesión en EE. UU., Escalada China-Taiwán, Inversión de la Curva de Rendimiento, Congelación del Mercado Crediticio, Crisis de Divisas en Mercados Emergentes, Escalada de Guerra Comercial, Crisis de Deuda Soberana

Conversaciones de ejemplo

"¿Cuál es el riesgo actual de recesión?"

Claude usa recession_probability y devuelve:

La probabilidad actual de recesión es del 37,9% (riesgo moderado). Postura de la Fed: neutral. Régimen de mercado: ciclo medio. Recomendación: Las señales mixtas requieren cautela. Comienza la rotación defensiva.

"¿Es un buen momento para comprar una propiedad de inversión a $450K?"

Claude usa investment_property_analysis + interest_rates:

A $450K con 20% de enganche al 7%, el flujo de caja mensual es de $287. Cap rate: 5,3%. Cash-on-cash: 4,2%. DSCR: 1,18 (saludable). Tasa hipotecaria actual a 30 años: 6,38%.

"¿Cuál es la señal de riesgo/aversión al riesgo del mercado?"

Claude usa sectors_rotation + institutional_cftc:

Señal de rotación sectorial: RISK_ON. Los sectores cíclicos lideran, los defensivos se quedan atrás. Posicionamiento institucional alineado con la búsqueda de riesgo. Estrategia: mantener sobreponderación en cíclicos, vigilar la ruptura de la rotación.

"¿Qué pasa si el petróleo llega a $120?"

Claude usa cascade_analysis + sectors_rotation:

Cascada de Shock de Oferta de Petróleo: La demanda de dólares aumenta (mecánico) -> Las reservas de divisas asiáticas se drenan (probable, semanas) -> Salidas de capital de acciones asiáticas (probable) -> Subidas de tasas forzadas en Asia (probable, meses). Rotación sectorial actual: RISK_ON, pero el sector energético rezagado sugiere que el mercado no ha descontado el riesgo de oferta. Estrategia: coberturas contra la inflación y reservas de efectivo. Vigila el uso de las líneas swap de la Fed como señal sistémica.

Configuración

Para el endpoint alojado, la autenticación se pasa como un encabezado Bearer en la configuración de tu cliente (ver Inicio rápido arriba) o se negocia vía OAuth en la primera conexión — no se necesitan variables de entorno.

Para la instalación local de npx:

Precios

Solución de problemas

Las herramientas no aparecen en Claude después de la instalación

1. Confirma que el servidor MCP está registrado: en Claude Desktop, revisa Configuración → Conectores (o Desarrollador) para market-intelligence. En Claude Code, ejecuta claude mcp list.
2. Reinicia Claude Desktop por completo (sal, no solo cierres la ventana) — los cambios de conectores no se recargan en caliente.
3. Verifica que tu variable de entorno BULLRUNDATA_API_KEY esté configurada y sea válida. Sin ella, las herramientas fallan en la primera llamada.
4. Si usas el servidor remoto (https://market.bullrundata.com/mcp) directamente, completa el flujo OAuth en tu navegador cuando se te solicite — Claude necesita el token bearer antes de poder llamar a las herramientas.

401 Unauthorized de una herramienta

Tu clave API falta, está caducada o inactiva. Obtén una nueva en bullrundata.com/login. Para el flujo del servidor remoto, vuelve a autenticarte a través de la pantalla OAuth; el conector aprovisiona automáticamente una clave de nivel gratuito en la primera conexión.

429 Too Many Requests

Alcanzaste tu límite diario de solicitudes. Los límites se restablecen a las 00:00 UTC.

Mejora tu plan en bullrundata.com/pricing o espera al restablecimiento UTC.

El flujo OAuth se atasca o expira (servidor remoto)

El servidor remoto usa OAuth de GitHub. Si la redirección se cuelga:

1. Confirma que las cookies y las ventanas emergentes estén permitidas para market.bullrundata.com y claude.ai
2. Intenta autorizar en una ventana de incógnito (borra el estado OAuth en caché)
3. Verifica que https://market.bullrundata.com/.well-known/oauth-authorization-server devuelva 200 en tu navegador

La primera solicitud es lenta (~2–4 segundos)

Latencia de arranque en frío en el despliegue serverless. Las solicitudes posteriores en la misma sesión deberían responder en <500ms.

cascade_analysis devuelve "live data unavailable"

La herramienta de cascada opcionalmente enriquece con datos de mercado en vivo de BullrunData. Si la API ascendente no está disponible brevemente, aún obtendrás el árbol de catalizadores completo — solo se omite la superposición en vivo. Pasa include_live_data: false para omitir la obtención en vivo por completo.

La herramienta devuelve datos desactualizados

Los indicadores económicos se actualizan varias veces al día. Revisa data_freshness en dashboard_summary para ver la marca de tiempo de la última actualización.

Sigue atascado

Abre un problema en GitHub Issues o envía un correo a support@bullrundata.com con: nombre de la herramienta, mensaje de error completo y marca de tiempo aproximada.

Soporte

• Sitio web: bullrundata.com
• Documentación: bullrundata.com/docs
• Problemas: GitHub Issues

Licencia

Elastic License 2.0 — ver LICENSE.

Puedes usar, modificar y redistribuir este software. No puedes ofrecerlo como un servicio alojado o gestionado que proporcione a los usuarios acceso a un conjunto sustancial de las características o funcionalidades del software.