Cal MCP Server

Ипотечный MCP-сервер с настоящим преимуществом в данных о кредиторах. 166+ оптовых кредиторов · 1 400+ проиндексированных программных документов · 250+ программ помощи с первоначальным взносом · 50 штатов. Первый MCP-сервер в ипотечной отрасли с доступными брокерам матричными данными — не калькулятор и не скрейпер ставок.

@askcal/mcp-server предоставляет доступ к Cal — AI-платформе для ипотеки на askcal.io — любому клиенту Model Context Protocol: Claude Desktop, Cursor, Continue, Goose, Zed, Cody, вашему собственному агенту. Кредитные специалисты, брокеры, риелторы и заёмщики могут задавать своему AI-ассистенту вопросы вроде:

• «Какой лимит конформных кредитов на 2026 год в округе Аламида, Калифорния, для 1-квартирного дома?»

• «Топ-5 оптовых кредиторов по джумбо-кредитам в Калифорнии для кредита с FICO 712, LTV 80%, суммой $1,4 млн, при условии что прежнее жильё ещё в собственности.»

• «Какие программы помощи с первоначальным взносом в округе Ориндж, Калифорния, подходят заёмщику с FICO 700, покупающему жильё впервые?»

• «Plaza Home Mortgage — какие у них актуальные кредитные руководства и кто их региональный представитель по Северной Калифорнии?»

• «Покажи схему структурирования сделки по FHA с FICO ниже 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 → Add Server, затем вставьте тот же 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"}'

В ответе будет поле key, начинающееся с cal_live_. Скопируйте его сейчас — оно показывается только один раз. Используйте его как CAL_API_TOKEN. Ключ не имеет срока действия; отозвать его можно в любой момент через DELETE /auth/api-keys/<id> (список ключей — через GET /auth/api-keys).

Запасной вариант — сессионный токен

Если нужно просто быстро попробовать вызов, подойдёт и сессионный токен из /auth/login (срок действия 8 часов). Не помещайте его в долгоживущий конфиг MCP.

Превью v0.2

OAuth 2.1 с PKCE — в дорожной карте, чтобы 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 — это AI-платформа для ипотеки на askcal.io, созданная ветераном отрасли с 17-летним стажем (NMLS 275073) для действующих брокеров. Состояние на момент этого релиза:

• 166 оптовых кредиторов, 1 424 проиндексированных программных документа, 250 программ DPA, 50 штатов

• 4 кредитных специалиста в пилоте, 342 вопроса отвечено за первые 24 часа мягкого запуска

Дорожная карта

• v0.1 — 7 инструментов, авторизация по API-ключу, stdio-транспорт, npm + GitHub.

• v0.2 (текущая) — оценка ValueGuard (cal_valuation), всего 8 инструментов; переведено на API askcal.io.

• v0.3 — OAuth 2.1 с PKCE. Пакет .dxt для Claude Desktop. Компаньон-сервер для Optimal Blue MCP.

• v0.4 — Потоковый HTTP-транспорт. Публичные агентские MCP (Selling Guide Fannie, Guide Freddie, FHA Handbook 4000.1, VA Handbook 26-7, лимиты FHFA, AMI HUD).

• v0.5 — Компаньон MCP для Encompass (чтение/запись LOS). Компаньон MCP для DocuSign. Один промпт запускает действия через CRM + email + календарь + ценообразование + библиотеку.

Участие в разработке

Приветствуются issues и pull request'ы. Дорожная карта выше — это порядок приоритетов; если хотите взять какую-то часть, сначала откройте issue, чтобы мы не работали параллельно над одним и тем же.

Контакты

Chris Black · NMLS 275073 · chris@askcal.io