Cal MCP Server

Der Hypotheken-MCP-Server mit einem echten Kreditgeber-Datenmoat. 166+ Großhandelskreditgeber · 1.400+ indizierte Programmdokumente · 250+ Programme zur Anzahlungshilfe · 50 Bundesstaaten. Erster Model Context Protocol Server in der Hypothekenbranche mit brokerzugänglichen Matrixdaten dahinter – kein Taschenrechner, kein Zins-Scraper.

@askcal/mcp-server stellt Cal – die KI-Hypothekenplattform auf askcal.io – jedem Model Context Protocol-Client zur Verfügung: Claude Desktop, Cursor, Continue, Goose, Zed, Cody, deinem eigenen Agenten. Kreditbeauftragte, Makler, Immobilienmakler und private Kreditnehmer können ihrem KI-Assistenten Fragen stellen wie:

• „Wie hoch ist das konforme Darlehenslimit 2026 in Alameda County, CA, für eine 1‑Einheit?"

• „Top 5 Großhandels-Jumbo-Kreditgeber in Kalifornien für ein 712‑FICO, 80% LTV, 1,4 Mio. $ Darlehen mit einer noch gelisteten bisherigen Residenz."

• „Welche DPA-Programme in Orange County, Kalifornien, funktionieren für einen Erstkäufer mit 700 FICO?"

• „Plaza Home Mortgage – was ist ihr aktuelles Master-Kreditrichtliniendokument und welcher AE ist für Nordkalifornien zuständig?"

• „Zeig mir das Strukturierungs-Playbook für eine sub‑580 FHA-Datei."

…und Cal liefert Antworten, die auf aktuellen Matrix-PDFs, FHFA / HUD / VA-Quelldokumenten und Tribal-Knowledge-Intelligenz basieren, die von arbeitenden Maklern kuratiert wird.

Warum das wichtig ist

Die Hypothekenbranche hat ein Jahrzehnt in der Ära „jeder kauft Encompass" verbracht. KI hat den Workflow nicht berührt, weil die Quelldaten gesperrt, fragmentiert und ablaufend sind. Cal's Bibliothek – aufgebaut aus Broker-Portal-Scrapes, wöchentlich indiziert, aktuell gehalten – ist die Datenschicht, die jede Hypotheken-KI tatsächlich nützlich macht. Dieser MCP-Server ist der Weg, über den diese Daten jede Agentenplattform erreichen, die auf MCP aufbaut.

Wenn du ein LO bist, bedeutet das, Claude (oder Cursor oder deinen eigenen Agenten) dieselben Fragen zu stellen, die du früher durch PDFs wühlen musstest – und in Sekunden eine Antwort mit Quellenangabe zu erhalten.

Related MCP server: Repliers MCP Server

Tools

Der Server stellt acht Tools bereit:

Die Tool-Oberfläche spiegelt Cal's internes Tool-Use-Schema wider, sodass jedes Modell (Claude Sonnet, Opus, Haiku, GPT‑4o, Gemini, …), das sie aufruft, dieselbe Form erhält, die Cal selbst verwendet.

Installation

Claude Desktop (macOS / Windows)

Füge dies zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows) hinzu:

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

Starte Claude Desktop neu. Die cal-Tools erscheinen im Slash-Menü.

Cursor

Einstellungen → MCP → Server hinzufügen, dann dasselbe JSON einfügen.

Continue / VS Code

~/.continue/config.json → mcpServers-Block, gleiche Form.

Lokale Entwicklung (Klonen + Verknüpfen)

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

Ein Token erhalten

CAL_API_TOKEN ist ein undurchsichtiges Bearer-Token. Verwende einen langlebigen API-Schlüssel, kein Sitzungstoken – Sitzungstoken von /auth/login laufen nach 8 Stunden ab, was bedeutet, dass eine MCP-Client-Konfiguration, die heute funktioniert hat, morgen 401 zurückgibt.

Empfohlen – langlebiger API-Schlüssel (cal_live_…)

Melde dich auf api.askcal.io an (fordere Zugriff an, falls du noch keinen Schlüssel hast – Broker-LOs werden automatisch genehmigt). Dann:

# 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"}'

Die Antwort enthält ein key-Feld, das mit cal_live_ beginnt. Kopiere es jetzt – es wird nur einmal angezeigt. Verwende es als CAL_API_TOKEN. Der Schlüssel hat kein Ablaufdatum; widerrufe ihn jederzeit mit DELETE /auth/api-keys/<id> (liste deine mit GET /auth/api-keys auf).

Fallback – Sitzungstoken

Wenn du nur schnell einen Tool-Aufruf ausprobieren möchtest, funktioniert auch das Sitzungstoken von /auth/login (8‑Stunden-TTL). Setze keines in eine langlebige MCP-Konfiguration.

v0.2 Vorschau

OAuth 2.1 mit PKCE ist auf der Roadmap, damit MCP-Clients den Zustimmungsfluss selbst ausführen können. Bis dahin ist der obige API-Schlüssel-Fluss der empfohlene Weg.

Verifizieren, dass es funktioniert

Nach der Installation frage deinen MCP-Client:

„Wie hoch ist das konforme Darlehenslimit 2026 in Alameda County, CA?"

Du solltest so etwas zurückbekommen:

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

Falls nicht, überprüfe:

1. Das Token ist nicht abgelaufen – Cal-Sitzungstoken halten standardmäßig 24 Stunden. Aktualisiere über /auth/login.

2. Das Netzwerk kann https://api.askcal.io erreichen.

3. Dein MCP-Client hat die Konfiguration übernommen – starte ihn nach der Bearbeitung neu.

Konfiguration

Datenumfang

Aufrufe sind auf die Liste beschränkt, die mit deinem Token verknüpft ist. Wenn du ein Broker-LO mit einer kuratierten Liste genehmigter Kreditgeber bist, werden Ergebnisse auf Kreditgeber gefiltert, die du tatsächlich nutzen kannst. Cal wird nicht über genehmigte Listen hinweg leaken. Die Demo-Liste des Gründers ist die breiteste, mit 166 Kreditgebern.

Lizenz

MIT. Der Wrapper-Code ist offen. Cal's kuratierte Kreditgeber-Bibliothek, DPA-Programmdaten und Kreditgeber-Intelligenz sind proprietär und bleiben hinter der API.

Über Cal

Cal ist die KI-Hypothekenplattform auf askcal.io, gebaut von einem 17‑jährigen Branchenveteranen (NMLS 275073) für arbeitende Makler. Produktionsstand bei dieser Veröffentlichung:

• 166 Großhandelskreditgeber, 1.424 indizierte Programmdokumente, 250 DPA-Programme, 50 Bundesstaaten

• 4 LOs im Pilotbetrieb, 342 Fragen in den ersten 24 Stunden des Soft-Launchs beantwortet

Roadmap

• v0.1 - 7 Tools, API-Schlüssel-Authentifizierung, stdio-Transport, npm + GitHub.

• v0.2 (aktuell) - ValueGuard-Bewertung (cal_valuation), insgesamt 8 Tools; auf die askcal.io-API umgestellt.

• v0.3 - OAuth 2.1 mit PKCE. .dxt Claude Desktop-Bundle. Optimal Blue MCP-Begleitserver.

• v0.4 - Streamable HTTP-Transport. Öffentliche Agentur-MCPs (Fannie Selling Guide, Freddie Guide, FHA Handbook 4000.1, VA Handbook 26-7, FHFA-Limits, HUD AMI).

• v0.5 - Encompass MCP-Begleiter (LOS lesen/schreiben). DocuSign MCP-Begleiter. Ein Prompt feuert über CRM + E-Mail + Kalender + Preisgestaltung + Bibliothek.

Mitwirken

Issues und PRs sind willkommen. Die obige Roadmap ist die Prioritätsreihenfolge; wenn du ein Stück übernehmen möchtest, öffne zuerst ein Issue, damit wir nicht doppelt arbeiten.

Kontakt

Chris Black · NMLS 275073 · chris@askcal.io