Cal MCP 服务器

抵押贷款 MCP 服务器，拥有真实的贷款机构数据护城河。166+ 家批发贷款机构 · 1,400+ 份已索引的计划文件 · 250+ 个首付援助计划 · 覆盖全美 50 个州。 抵押贷款行业首个 Model Context Protocol 服务器，背后是经纪人可访问的矩阵数据——不是计算器，也不是利率抓取器。

@askcal/mcp-server 将 Cal——位于 askcal.io 的 AI 抵押贷款平台——开放给任何 Model Context Protocol 客户端：Claude Desktop、Cursor、Continue、Goose、Zed、Cody，以及你自己的智能体。贷款专员、经纪人、房地产经纪人和个人借款人都可以问他们的 AI 助手类似这样的问题：

• "2026 年加州阿拉米达县单户住宅的合规贷款上限是多少？"

• "加州排名前 5 的批发巨额贷款机构，适用于 712 FICO 分、80% LTV、140 万美元贷款、且仍有自住房在挂牌出售的借款人？"

• "加州橙县有哪些首付援助计划适合 FICO 700 分的首次购房者？"

• "Plaza Home Mortgage——他们最新的主信贷指引文件是什么，哪位区域经理负责北加州？"

• "给我看看 FHA 580 分以下贷款文件的结构化操作手册。"

……Cal 会基于最新的矩阵 PDF、FHFA / HUD / VA 源文件，以及由在职经纪人整理的行内知识情报，返回有据可查的答案。

为什么这很重要

抵押贷款行业在"人人都在用 Encompass"的时代已经过去了十年。AI 之所以没有触及工作流程，是因为源数据受到限制、碎片化严重，而且会过期。Cal 的数据库——通过抓取经纪人门户构建、每周索引、持续更新——正是让任何抵押贷款 AI 真正有用的数据层。这个 MCP 服务器就是让这些数据触达构建在 MCP 之上的每一个智能体平台的方式。

如果你是一名贷款专员，这意味着你可以问 Claude（或 Cursor，或你自己的智能体）那些过去需要翻遍 PDF 才能回答的问题——并在几秒钟内获得带来源引用的答案。

Related MCP server: Repliers MCP Server

工具

该服务器提供八个工具：

工具表面与 Cal 内部工具调用模式保持一致，因此任何调用这些工具的模型（Claude Sonnet、Opus、Haiku、GPT-4o、Gemini 等）都能获得与 Cal 自身相同的数据结构。

安装

Claude Desktop（macOS / Windows）

将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

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

重启 Claude Desktop。cal 工具会出现在斜杠菜单中。

Cursor

设置 → MCP → 添加服务器，然后粘贴相同的 JSON。

Continue / VS Code

~/.continue/config.json → mcpServers 代码块，格式相同。

本地开发（克隆 + 链接）

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

获取令牌

CAL_API_TOKEN 是一个不透明的 Bearer 令牌。请使用长期有效的 API 密钥，而不是会话令牌——来自 /auth/login 的会话令牌会在 8 小时后过期，这意味着今天还能用的 MCP 客户端配置，明天就会返回 401。

推荐——长期有效的 API 密钥（cal_live_…）

在 api.askcal.io 注册（如果还没有密钥，请申请访问权限——经纪人贷款专员会自动获批）。然后：

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

响应中包含一个以 cal_live_ 开头的 key 字段。请立即复制——它只显示一次。 将其用作 CAL_API_TOKEN。该密钥永不过期；可随时使用 DELETE /auth/api-keys/<id> 撤销（使用 GET /auth/api-keys 列出你的密钥）。

备选——会话令牌

如果你只是想快速测试一次工具调用，来自 /auth/login 的会话令牌也可以使用（8 小时有效期）。但不要将其放入长期有效的 MCP 配置中。

v0.2 预览

支持 PKCE 的 OAuth 2.1 已在路线图中，届时 MCP 客户端可以自行运行同意流程。在此之前，上述 API 密钥流程是推荐方式。

验证是否正常工作

安装后，向你的 MCP 客户端提问：

"2026 年加州阿拉米达县的合规贷款上限是多少？"

你应该会收到类似这样的回复：

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

如果没有，请检查：

1. 令牌是否过期——Cal 会话令牌默认有效期为 24 小时。通过 /auth/login 刷新。

2. 网络是否可以访问 https://api.askcal.io。

3. 你的 MCP 客户端是否已加载配置——编辑后请重启。

配置

数据范围

调用范围限定为与你的令牌关联的列表。如果你是拥有精选批准贷款机构列表的经纪人贷款专员，结果将过滤为你可以实际使用的贷款机构。Cal 不会跨批准列表泄露数据。创始人的演示列表范围最广，包含 166 家贷款机构。

许可证

MIT。包装器代码是开源的。Cal 精选的贷款机构库、DPA 计划数据和贷款机构情报均为专有数据，保留在 API 之后。

关于 Cal

Cal 是位于 askcal.io 的 AI 抵押贷款平台，由一位拥有 17 年行业经验的人士（NMLS 275073）为在职经纪人打造。此版本的生产状态：

• 166 家批发贷款机构、1,424 份已索引的计划文件、250 个 DPA 计划、覆盖 50 个州

• 4 名贷款专员参与试点，软启动前 24 小时内回答了 342 个问题

路线图

• v0.1 - 7 个工具、API 密钥认证、stdio 传输、npm + GitHub。

• v0.2 （当前） - ValueGuard 估值（cal_valuation），共 8 个工具；已指向 askcal.io API。

• v0.3 - 支持 PKCE 的 OAuth 2.1。.dxt Claude Desktop 捆绑包。Optimal Blue MCP 配套服务器。

• v0.4 - 可流式 HTTP 传输。公共机构 MCP（Fannie Selling Guide、Freddie Guide、FHA Handbook 4000.1、VA Handbook 26-7、FHFA 限额、HUD AMI）。

• v0.5 - Encompass MCP 配套（LOS 读写）。DocuSign MCP 配套。一个提示词即可跨 CRM + 电子邮件 + 日历 + 定价 + 数据库执行。

贡献

欢迎提交 Issue 和 PR。上述路线图即优先级顺序；如果你想认领其中一项，请先开一个 Issue，以免重复工作。

联系方式

Chris Black · NMLS 275073 · chris@askcal.io