PreReason

PreReason le da a un agente de IA un contexto de mercado con el que puede razonar, en lugar de números crudos. Una sola llamada devuelve un informe con el análisis ya incluido: una línea de señal, dirección de tendencia en varias ventanas, puntuaciones de confianza, rangos percentiles y correlaciones, y en los informes más profundos una etiqueta de régimen y una narrativa en lenguaje sencillo. Los informes cubren Bitcoin, liquidez macro, FX y correlaciones entre activos. El catálogo contiene 19 informes en vivo y 212 métricas individuales, entre ellas el precio y el impulso de Bitcoin, la salud de la red y de los mineros, los flujos de ETF spot de Bitcoin, las tesorerías corporativas de Bitcoin, el balance de la Fed, M2, liquidez neta, rendimientos del Tesoro y el dólar. Se sirve a través de MCP (un servidor remoto y un puente npm) y a través de REST, como Markdown o JSON. Las herramientas del catálogo no necesitan clave, y un agente puede obtener una clave gratuita desde la sesión: muestra un enlace, una persona lo aprueba y la clave llega.

Inicio Rápido

Opción 1: Claude Desktop, sin necesidad de clave

Requiere Node.js 18+, y nada más: el puente no tiene dependencias.

Agrega esto a claude_desktop_config.json y reinicia Claude Desktop:

{
  "mcpServers": {
    "prereason": {
      "command": "npx",
      "args": ["-y", "@prereason/mcp"],
      "env": { "PREREASON_CLIENT": "claude-desktop" }
    }
  }
}

Las herramientas del catálogo funcionan de inmediato. La primera vez que un informe necesite una clave, el puente solicita acceso: pide a Claude cualquier informe y la respuesta comienza con Approve at https://www.prereason.com/claim/PR-XXXX-XXXX. Abre el enlace, inicia sesión o crea una cuenta gratuita, haz clic en Aprobar. La clave llega al puente por sí sola, se guarda en ~/.prereason/credentials.json, y la siguiente llamada funciona. No se crea nada en tu cuenta hasta que hagas clic en Aprobar. Si tu cuenta ya tiene tantas claves API como permite, la respuesta lo dice en lugar de repetirse: revoca una clave en Configuración en prereason.com y reinicia Claude, o establece PREREASON_API_KEY a una clave que ya tengas.

Ubicación del archivo de configuración:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

¿Ya tienes una clave? Agrégala al bloque env como "PREREASON_API_KEY": "pr_live_..." y el puente nunca la pedirá.

Opción 2: HTTP directo con una clave API (Claude Code, Cursor, Windsurf, Codex, Gemini CLI, VS Code, scripts)

Los clientes que manejan su propia configuración pueden llamar al endpoint directamente, con la clave como encabezado:

# Claude Code
claude mcp add --transport http prereason https://api.prereason.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

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

Windsurf usa serverUrl en lugar de url; Gemini CLI usa httpUrl; Codex usa url más bearer_token_env_var en config.toml. ¿Aún no tienes clave? Apunta el cliente al endpoint sin encabezado para explorar el catálogo, luego crea una clave en el sitio web (abajo) y agrega el encabezado.

Opción 3: Conector personalizado de Claude.ai y Claude Desktop

Agrega PreReason como conector personalizado, elige "Sin inicio de sesión", y donde esté disponible la sección de encabezados de solicitud agrega Authorization con el valor Bearer YOUR_API_KEY (la palabra Bearer y el espacio son parte del valor). El soporte de inicio de sesión para conectores se está volviendo a probar y no se ofrece hasta que se verifique.

Obtén una Clave API

Tres formas, todas gratuitas. El servidor alojado nunca entrega una clave dentro de una sesión y nunca la solicita.

A través de este puente. Ejecútalo sin clave configurada: solicita acceso a PreReason en tu nombre y muestra un approve_url, en su registro y frente a cualquier respuesta que necesite una clave. Ábrelo, inicia sesión o crea tu cuenta, haz clic en Aprobar, y el puente guarda la clave, vinculada a tu cuenta y nombrada Agent: <client_name>.

Desde código, para un agente sin navegador. POST https://api.prereason.com/api/agent/claims (sin autenticación), muestra al humano el approve_url, luego consulta GET https://api.prereason.com/api/agent/claims/{claim_code} con Authorization: Bearer <claim_token> hasta que status sea approved. Documentación: prereason.com/docs#agent-access.

En el sitio web. Regístrate en prereason.com/signup, luego Panel > Configuración > Claves API. Las claves comienzan con pr_live_.

5 Herramientas MCP

Herramienta	Autenticación	Descripción
list_briefings	Abierta	Lista los 19 informes de mercado pre-razonados con requisitos de nivel
list_metrics	Abierta	Lista cada métrica disponible en las categorías bitcoin, macro, calculada y eth
get_health	Abierta	Verificación de salud de la API, versión, nivel de cuenta
get_context	Requerida	Obtiene un informe de mercado pre-razonado (markdown o JSON)
get_metric	Requerida	Obtiene una métrica individual con tendencia/señal/percentil

19 Informes de Mercado

Gratis (6 informes)

Informe	Descripción
btc.quick-check	Contexto rápido mínimo: BTC + Liquidez Neta + correlación
btc.context	BTC + liquidez + hash ribbon + dificultad + impulso
macro.snapshot	Balance de la Fed, M2, rendimientos del Tesoro, fortaleza del dólar, liquidez neta
cross.correlations	Matriz de correlación de BTC vs indicadores macro
btc.pulse	Precio, cambio en 24h, dominancia de Bitcoin
btc.grid-stress	Ritmo de época y pronóstico de ajuste de dificultad

Básico - $19.99/mes (6 informes)

Informe	Descripción
btc.momentum	Soporte/resistencia de MA de 200 días con impulso de 7d/30d/90d y clasificaciones percentiles
macro.liquidity	Indicadores de liquidez con análisis de impulso
btc.on-chain	Hash rate, dificultad, transacciones, direcciones activas
cross.breadth	Amplitud en SPY, QQQ e IWM, con la correlación de Bitcoin con cada uno
btc.miner-survival	Termómetro de hashprice con puntuación de estrés de mineros
btc.etf-flows	Flujos netos diarios de ETF spot de BTC, AUM agregado y desglose por emisor

Pro - $49.99/mes (7 informes)

Informe	Descripción
btc.full	Análisis completo de Bitcoin: superposición macro, impulso, percentiles, correlaciones y narrativa
btc.factors	Atribución multifactorial para movimientos de precio de BTC
cross.regime	Clasificación de régimen (riesgo-on/riesgo-off/transición) con sentimiento de riesgo USDT.D
fx.liquidity	EUR/USD, USD/CNY y fortaleza del dólar, con liquidez neta y correlaciones de Bitcoin
btc.energy	Modelo de costo de producción con presión de entrada de gas
btc.treasury	Inteligencia de tesorería corporativa de Bitcoin a partir de presentaciones SEC
macro.rates	Curva de rendimiento par del Tesoro en cada vencimiento, de 1M a 30Y, inflación de equilibrio, forward 5y5y, Alemania 10Y

Ejemplos de Prompts

Una vez conectado, prueba prompts como:

• "Dame el chequeo rápido de Bitcoin"
• "Muéstrame la instantánea macro"
• "¿Qué dice el informe de contexto de BTC sobre las condiciones del mercado?"
• "Obtén la métrica de precio de bitcoin con análisis de tendencia"
• "¿Cuál es la señal de hash ribbon ahora mismo?"
• "Lista los informes disponibles"

Solución de Problemas

Error de "Servidor desconectado"

• Asegúrate de que Node.js 18+ esté instalado: node --version
• Verifica que tu clave API comience con pr_live_
• Cierra completamente Claude Desktop (bandeja del sistema > Salir) y vuelve a abrirlo

Las herramientas no aparecen

• Reinicia Claude Desktop después de editar la configuración
• Verifica la sintaxis JSON: node -e "JSON.parse(require('fs').readFileSync('path/to/config','utf8'))"

Windows: "'C:\Program' no se reconoce"

Si aún ves este error, asegúrate de usar el bloque env (no los argumentos --header) como se muestra en Inicio Rápido arriba. Si el problema persiste, instala globalmente y usa node:

1. Ejecuta: npm install -g @prereason/mcp
2. Usa esta configuración (reemplaza YOUR_USER con tu nombre de usuario de Windows):

{
  "mcpServers": {
    "prereason": {
      "command": "node",
      "args": [
        "C:\\Users\\YOUR_USER\\AppData\\Roaming\\npm\\node_modules\\@prereason\\mcp\\bin\\cli.js"
      ],
      "env": {
        "PREREASON_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Errores de autenticación en get_context / get_metric

• list_briefings, list_metrics y get_health funcionan sin clave
• get_context y get_metric requieren una clave API válida
• Obtén una clave gratuita en prereason.com/signup

Otros Clientes MCP

Si tu cliente admite servidores HTTP remotos, usa Inicio Rápido Opción 2 arriba. El paquete del puente stdio solo es necesario para clientes que requieren transporte stdio (por ejemplo, Claude Desktop).

Uso de CLI

# No key: the bridge asks for access and prints one link to approve
npx @prereason/mcp

# Ask for access now, save the key, exit (useful before a first run)
npx @prereason/mcp --login

# Forget the saved key
npx @prereason/mcp --logout

# Use a key from the environment (never asks)
PREREASON_API_KEY=pr_live_... npx @prereason/mcp

# Name the app the bridge runs in, so your dashboard names the connection
PREREASON_CLIENT=claude-desktop npx @prereason/mcp

# --header (backward compatible), a custom credentials file, a custom endpoint
npx @prereason/mcp --header "Authorization:Bearer YOUR_API_KEY"
npx @prereason/mcp --credentials-file /path/to/credentials.json
PREREASON_URL=https://custom.endpoint/mcp npx @prereason/mcp

npx @prereason/mcp --help

Precedencia de claves: PREREASON_API_KEY, luego --header, luego el archivo de credenciales (~/.prereason/credentials.json, o PREREASON_CREDENTIALS_FILE, o --credentials-file), luego el flujo de reclamo. El archivo contiene la clave y qué reclamo la emitió, nunca un token de reclamo. En macOS y Linux el directorio se crea con 0700 y el archivo con 0600; Windows no tiene bits de modo, por lo que el archivo depende de los permisos de tu directorio de perfil como cualquier otro almacén de credenciales allí.

Extensión de Claude Desktop (.mcpb)

mcpb/manifest.json describe el mismo puente como una extensión de Claude Desktop de un solo clic, clave opcional. Para construir el paquete: npm install --omit=dev, luego npx @anthropic-ai/mcpb pack . desde el directorio del paquete, e instala el .mcpb resultante haciendo doble clic en él. El envío al directorio de Claude pasa por el formulario de extensión de escritorio y es una decisión del editor.

Sin dependencias

El puente incluye sus propios transportes y no instala nada. npm ls en él es una línea, npx @prereason/mcp obtiene un tarball de 23 KB y comienza, y el código que una revisión de seguridad tiene que leer es el código en este repositorio.

Solía depender de @modelcontextprotocol/sdk para dos clases, un transporte stdio y un cliente HTTP Streamable. Eso traía 91 paquetes y 25 MB en disco, casi todo la mitad del servidor del SDK: Express, Hono, CORS, un limitador de tasa, un cliente OAuth y un validador de esquemas, ninguno de los cuales un relay llama jamás. lib/stdio.js y lib/streamable-http.js reemplazan las dos clases que el puente usaba, mantienen su marco y sus callbacks, y están cubiertos por la suite bajo test/.

Enlaces

• Documentación
• Registro
• Descubrimiento de API
• Términos de Servicio
• Política de Privacidad

Política de Privacidad

Consulta prereason.com/privacy para conocer las prácticas de manejo de datos.

Licencia

MIT