Shelter MCP Server

Conecta Claude, Codex, Cursor y otros agentes compatibles con MCP a contexto financiero acotado de tu propia cuenta de Shelter.

El servidor es de solo lectura. Puede recuperar pronósticos, runway, alertas, oportunidades y orientación sobre asequibilidad, pero no puede mover dinero ni acceder a credenciales de Plaid.

Requisitos

• Node.js 20 o superior

• Una cuenta de Shelter con datos financieros conectados

• Una clave de API con alcance limitado desde shelter.money/developer

No se requiere una cuenta de desarrollador de Plaid.

Related MCP server: toshl-mcp-server

Inicio rápido

Crea una clave de API y configura tu cliente MCP para que ejecute:

npx -y @shelter.money/mcp

con SHELTER_API_KEY en el entorno del servidor.

Claude Desktop

{
  "mcpServers": {
    "shelter": {
      "command": "npx",
      "args": ["-y", "@shelter.money/mcp"],
      "env": {
        "SHELTER_API_KEY": "wv_your_key_here"
      }
    }
  }
}

Reinicia Claude Desktop después de guardar su configuración.

Codex

codex mcp add shelter --env SHELTER_API_KEY=wv_your_key_here -- npx -y @shelter.money/mcp

Cursor

Añade este servidor a la configuración MCP de Cursor:

{
  "shelter": {
    "command": "npx",
    "args": ["-y", "@shelter.money/mcp"],
    "env": {
      "SHELTER_API_KEY": "wv_your_key_here"
    }
  }
}

Herramientas disponibles

• shelter_status — estado de conexión y autoridad

• shelter_runway — runway de gasto seguro y presión futura

• shelter_forecast — previsión de flujo de caja vinculada al manifiesto

• shelter_alerts — alertas financieras actuales

• shelter_opportunities — oportunidades de ahorro accionables

• shelter_context — contexto financiero acotado para el razonamiento del agente

• shelter_affordability — simulación de asequibilidad de compra

• shelter_coach_daily — resumen diario de coaching

• shelter_coach_advice — coaching para el tema solicitado

• shelter_ask — pregunta a Guardian una cuestión financiera

El paquete también proporciona indicaciones de chequeo financiero, revisión de gastos y planificación de compras.

Variables de entorno

Si falta SHELTER_API_KEY, el servidor sigue exponiendo las definiciones de sus herramientas, pero devuelve respuestas suprimidas sin valores financieros. Nunca sustituye datos de dinero de muestra por el estado financiero real del usuario.

Modelo de seguridad

• El identidad del usuario final proviene solo de la clave de API de Shelter.

• Shelter almacena las claves como hash SHA-256 y las muestra en una sola ocasión al crearlas.

• Las claves pueden limitarse y revocarse en la página de desarrolladores de Shelter.

• La Agent API alojada aplica autenticación, autorización, límites de tarea y registro de auditoría.

• El paquete MCP no contiene el código backend de Shelter, secretos de despliegue, tokens de Plaid ni credenciales bancarias.

• Las respuestas financieras fallan de forma cerrada cuando no se dispone de datos autoritativos.

Trata la clave de API como una contraseña. No la guardes en un repositorio ni la pongas directamente en el historial de comandos en máquinas compartidas. Consulta SECURITY.md para notificar vulnerabilidades.

Desarrollo

npm ci
npm run typecheck
npm run build

Ejecúa el servidor stdio desde el paquete compilado:

SHELTER_API_KEY=wv_your_key_here node dist/bin/shelter-mcp.js

También se compila un punto de entrada HTTP Streamable sin estado para un alojamiento controlado:

SHELTER_API_KEY=wv_your_key_here npm start

El punto de entrada HTTP se vincula a 0.0.0.0 y no es la configuración recomendada para clientes personales. Usa stdio salvo que administres y asegures el entorno HTTP por tu cuenta.

Arquitectura

Este repositorio público contiene únicamente el adaptador MCP. Se conecta a la API de agente Shelter alojada, de solo lectura. Los cálculos financieros privados de Shelter, la puerta de autenticación, el esquema de base de datos y las credenciales de servicio no forman parte de este paquete.

Licencia

MIT