Servidor MCP de Cal

El servidor MCP hipotecario, con un foso de datos real de prestamistas. 166+ prestamistas mayoristas · 1,400+ documentos de programas indexados · 250+ programas de asistencia para el pago inicial · 50 estados. Primer servidor de Model Context Protocol en la industria hipotecaria con datos de matriz accesibles para corredores detrás — no una calculadora, no un raspador de tasas.

@askcal/mcp-server expone Cal — la plataforma hipotecaria de IA en askcal.io — a cualquier cliente de Model Context Protocol: Claude Desktop, Cursor, Continue, Goose, Zed, Cody, tu propio agente. Agentes de préstamos, corredores, agentes inmobiliarios y prestatarios consumidores pueden preguntarle a su asistente de IA cosas como:

• "¿Cuál es el límite de préstamo conforme de 2026 en el condado de Alameda, CA, para una unidad de 1?"

• "Top 5 de prestamistas mayoristas jumbo en California para un préstamo de 712 FICO, 80% LTV, $1.4M con una residencia anterior aún listada."

• "¿Qué programas de asistencia para el pago inicial en el condado de Orange, California funcionan para un comprador de primera vivienda con 700 FICO?"

• "Plaza Home Mortgage — ¿cuál es su documento maestro actual de guía de crédito, y qué AE cubre el norte de California?"

• "Muéstrame el manual de estructuración para un archivo FHA sub-580."

…y Cal devuelve respuestas fundamentadas en PDFs de matriz actuales, documentos fuente de FHFA / HUD / VA, e inteligencia tribal curada por corredores en activo.

Por qué esto importa

La industria hipotecaria ha pasado una década en la era de "todos compran Encompass". La IA no ha tocado el flujo de trabajo porque los datos fuente están restringidos, fragmentados y caducan. La biblioteca de Cal — construida a partir de extracciones de portales de corredores, indexada semanalmente, mantenida al día — es la capa de datos que hace que cualquier IA hipotecaria sea realmente útil. Este servidor MCP es cómo esos datos llegan a cada plataforma de agentes construida sobre MCP.

Si eres un LO, esto significa preguntarle a Claude (o Cursor, o tu propio agente) las mismas preguntas que solías responder escarbando en PDFs — y obtener una respuesta en segundos con una cita de fuente.

Related MCP server: Repliers MCP Server

Herramientas

El servidor expone ocho herramientas:

La superficie de herramientas refleja el esquema interno de uso de herramientas de Cal, de modo que cualquier modelo (Claude Sonnet, Opus, Haiku, GPT-4o, Gemini, …) que las llame obtiene la misma forma que usa Cal mismo.

Instalación

Claude Desktop (macOS / Windows)

Añade esto a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "cal": {
      "command": "npx",
      "args": ["-y", "@askcal/mcp-server"],
      "env": {
        "CAL_API_TOKEN": "your-token-here"
      }
    }
  }
}

Reinicia Claude Desktop. Las herramientas cal aparecen en el menú de barra diagonal.

Cursor

Configuración → MCP → Añadir servidor, luego pega el mismo JSON.

Continue / VS Code

~/.continue/config.json → bloque mcpServers, misma forma.

Desarrollo local (clonar + enlazar)

git clone https://github.com/askcal/cal-mcp-server.git
cd cal-mcp-server
npm install
npm run build
# Then point your MCP client at dist/index.js with `node` as the command
# and an absolute path in args[0].

Obtener un token

CAL_API_TOKEN es un token portador opaco. Usa una clave API de larga duración, no un token de sesión — los tokens de sesión de /auth/login caducan después de 8 horas, lo que significa que una configuración de cliente MCP que funcionaba hoy devolverá 401 mañana.

Recomendado — clave API de larga duración (cal_live_…)

Regístrate en api.askcal.io (solicita acceso si aún no tienes una clave — los LO corredores se aprueban automáticamente). Luego:

# 1. Get a short‑lived session token from /auth/login
SESSION=$(curl -s -X POST https://api.askcal.io/auth/login \
  -H "Content-Type: application/json" \
  -H "Origin: https://askcal.io" \
  -d '{"email":"<your-email>","password":"<your-password>","portal":"team"}' \
  | sed -n 's/.*"token":"\([^"]*\)".*/\1/p')

# 2. Mint a long‑lived API key
curl -X POST https://api.askcal.io/auth/api-keys \
  -H "Content-Type: application/json" \
  -H "Origin: https://askcal.io" \
  -H "Authorization: Bearer $SESSION" \
  -d '{"label":"my-claude-desktop"}'

La respuesta incluye un campo key que comienza con cal_live_. Cópiala ahora — solo se muestra una vez. Úsala como CAL_API_TOKEN. La clave no caduca; revócala en cualquier momento con DELETE /auth/api-keys/<id> (lista las tuyas con GET /auth/api-keys).

Alternativa — token de sesión

Si solo quieres probar una llamada de herramienta rápidamente, el token de sesión de /auth/login también funciona (TTL de 8 horas). No lo pongas en una configuración MCP de larga duración.

Vista previa v0.2

OAuth 2.1 con PKCE está en la hoja de ruta para que los clientes MCP puedan ejecutar el flujo de consentimiento ellos mismos. Hasta entonces, el flujo de clave API anterior es el camino recomendado.

Verificar que funciona

Después de instalar, pregúntale a tu cliente MCP:

"¿Cuál es el límite de préstamo conforme de 2026 en el condado de Alameda, CA?"

Deberías obtener algo como:

$1,229,100 (FHFA 2026 Conforming Loan Limits, announced 2025‑11‑26).
High‑balance HCOL county. Anything above this is a jumbo loan.

Si no, verifica:

1. Que el token no esté caducado — los tokens de sesión de Cal duran 24 horas por defecto. Renueva vía /auth/login.

2. Que la red pueda alcanzar https://api.askcal.io.

3. Que tu cliente MCP haya cargado la configuración — reinícialo después de editarla.

Configuración

Alcance de datos

Las llamadas están limitadas a la lista vinculada a tu token. Si eres un LO corredor con una lista curada de prestamistas aprobados, los resultados se filtran a prestamistas que realmente puedes usar. Cal no filtrará entre listas aprobadas. La lista de demostración del fundador es la más amplia, con 166 prestamistas.

Licencia

MIT. El código del wrapper es abierto. La biblioteca curada de prestamistas de Cal, los datos de programas DPA y la inteligencia de prestamistas son propietarios y permanecen detrás de la API.

Acerca de Cal

Cal es la plataforma hipotecaria de IA en askcal.io, construida por un veterano de la industria con 17 años (NMLS 275073) para corredores en activo. Estado de producción en este lanzamiento:

• 166 prestamistas mayoristas, 1,424 documentos de programas indexados, 250 programas DPA, 50 estados

• 4 LO en piloto, 342 preguntas respondidas en las primeras 24 horas del lanzamiento suave

Hoja de ruta

• v0.1 — 7 herramientas, autenticación con clave API, transporte stdio, npm + GitHub.

• v0.2 (actual) — Valoración ValueGuard (cal_valuation), 8 herramientas en total; redirigido a la API de askcal.io.

• v0.3 — OAuth 2.1 con PKCE. Paquete .dxt para Claude Desktop. Servidor complementario MCP de Optimal Blue.

• v0.4 — Transporte HTTP streamable. MCPs de agencias públicas (Guía de venta de Fannie, Guía de Freddie, Manual FHA 4000.1, Manual VA 26-7, límites FHFA, AMI de HUD).

• v0.5 — Complemento MCP de Encompass (lectura/escritura LOS). Complemento MCP de DocuSign. Un solo prompt dispara a través de CRM + correo + calendario + precios + biblioteca.

Contribuciones

Issues y PRs bienvenidos. La hoja de ruta anterior es el orden de prioridad; si quieres tomar una parte, abre un issue primero para no trabajar en paralelo.

Contacto

Chris Black · NMLS 275073 · chris@askcal.io