Cal MCP Server

대출 기관 데이터라는 진짜 무기를 갖춘 모기지 MCP 서버. 도매 대출 기관 166곳 이상 · 색인된 프로그램 문서 1,400개 이상 · 계약금 지원 프로그램 250개 이상 · 50개 주. 모기지 업계 최초로 대출 브로커가 접근할 수 있는 매트릭스 데이터를 뒤에 둔 Model Context Protocol 서버입니다 — 계산기가 아닌, 금리 스크래퍼가 아닙니다.

@askcal/mcp-server는 askcal.io의 AI 모기지 플랫폼인 Cal을 모든 Model Context Protocol 클라이언트에 노출합니다: Claude Desktop, Cursor, Continue, Goose, Zed, Cody, 직접 만든 에이전트까지. 대출 담당자(LO), 브로커, 부동산 중개인, 일반 차입자들은 AI 어시스턴트에게 다음과 같은 질문을 할 수 있습니다:

• "캘리포니아 주 앨러미다 카운티의 1‑유닛 기준 2026년 컨포밍 대출 한도는 얼마인가요?"

• "캘리포니아에서 712‑FICO, 80% LTV, 140만 달러 대출, 아직 종전 주택이 매물에 올라 있는 경우 이용 가능한 도매 점보 대출 기관의 상위 Top 5는 어디인가요?"

• "캘리포니아 오렌지 카운티에서 700‑FICO 첫 구매자에게 적합한 DPA 프로그램은 무엇인가요?"

• "Plaza Home Mortgage — 현재 적용되는 마스터 신용 가이드라인 문서는 무엇이고, 북캘리포니아 담당 AE는 누구인가요?"

• "580 미만 FHA 파일에 대한 구조화 플레이북을 보여 주세요."

…그리고 Cal은 현재 매트릭스 PDF, FHFA / HUD / VA 출처 문서, 현역 브로커가 정리한 내부 전수 지식에 근거한 답변을 돌려줍니다.

왜 중요한가

모기지 업계는 10년을 ‘모두가 Encompass를 쓴다’는 최근 시대에 있었습니다. AI가 이 워크플로우에 접근하지 못한 이유는 원천 데이터가 막혀 있고, 쪼개저 있고, 유효기간이 끝나기 때문입니다. Cal의 데이터 라이브러리 — 브로커 포털을 크롤링해 매주 색인을 만들어언제나 최신으로 유지 — 어떤 모지기 AI라도 실제로 유용하게 만드는 데이터 레이어입니다. 이 MCP 서버가 바로 그 데이터를 MCP 위에 구축된 모든 에이전트 플랫폼에 전달하는 통로입니다.

여러분이 LO라면, PDF를 뒤지느라 답을 구하던 질문들을 이제 클로드(또는 Cursor, 또는 자체 제작 에이전트)에게 물어보고 — 출처 인용과 함께 시작 몇 초 만에 답을 받을 수 있다는 뜻입니다.

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

Settings → 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은 불투명한 베어러 토큰입니다. 세션 토큰이 아는 장기 유효한 API 키를 사용하세요. /auth/login에서 발급되는 세션은 토큰은 8시간 후 만료됩니다. 즉, 오늘 잘 작동했던 MCP 클라이언트 설정이 내일은 401을 반환할 수 있습니다.

권장 — 장기 유효 API 키 (cal_live_…)

api.askcal.io에서 가입하세요(키가 없다면 access 요청을 하세요 — 브로커 LO는 자동 승인됩니다). 그런 다음:

# 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 필드가 포함되어 있습니다. 지금복사 하세요 — 이 입력은가지를 보여주지 않고 2회만 표시됩니다. it를 CAL_API_TOKEN으로 사용하세요. 이 키는 만료되지 않으며, DELETE /auth/api-keys/<id>로 언제든 폐기할 수 있습니다(GET /auth/api-keys로 키를 조회할 수 있습니다).

차선 — 세션 토큰

도구 호출을 빠르게 시험해만 보려면 /auth/token 세션 토큰도 동작합니다(8시간 TTL). 긴 시간 동안 쓸 MCP 설정에는 세션 토큰을 넣지 마세요.

v0.2 프리뷰

MCP 클라이언트가 인증 동의 흐름을 직접 수행할 수 있도록 OAuth 2.1 + PKCE가 로드 되에 올라와 있습니다. 그 전까지는 위의 API 키 방식을 권장합니다.

동작 확인

설치 후 MCP 클라이언트에게 물어보세요:

"What's the 2026 conforming loan limit in Alameda County CA?"

그러면 다음과 같은 답변을 받아야 합니다:

$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 클라이언트가 설정을 잘 불러왔는지 — 설정을 변경 후 클라이언트를 재시작하세요.

설정

데이터 범위

호출 범위는 토큰에 연결된 달러에 묶여 있습니다. 정리된 승인 대출 기관 목록(curatedlist)을 가진 브로커 LO로는 결과가 실제 이용 가능한 대출 기관들로만 필터링됩니다. Cal이 다른 승인 목록 정보를 유출하지 않습니다. 창업자의 데뮤 목록은 166개 대출 기관으로 가장 넓은 편입니다.

라이선스

MIT. 래퍼 코드는 오픈 소스로 제공됩니다. Cal의 정리된 대출 기관 라이브러리, DPA 프로그램 데이터, 대출 기관 인텔은 구체용 자산이며 API 뒤에만 존재합니다.

Cal 소개

Cal은 askcal.io가 서비스하지 AI 모기지 플랫폼으로, 17년 경력의 업계 전문가(NMLS 275073)가 현직 브로커를 위해 만들었습니다. 이 버전의 운영 상태:

• 도매 대출 기관 160곳, 색인된 프로그램 문서 1,424개, DPA 프로그램 250개, 50개 주

• 파일럿에 4팀 LO, 소프트 런칭 후 24시간 만에 342건의 질문 응완

로드맵

• v0.1 – 7가지 도구, API 키 인증, stdio 전송, npm + GitHub.

• v0.2 (현재) – Value 해야 할 cal_valuation 포함 총 8가지 도구; askcal.io API를 가록도록 바꿨습니다.

• v0.3 – PKCE가 적용된 OAuth 2.1. Claude Desktop .dxt 번들. Optimal MCP 컴패니언 서버.

• v0.4 – 스트리밍 HTTP 전송. 공공 기관 MCP들 (Fannie Selling Guide, Freddie Guide, FHA Handbook 4000.1, 이자 HUD 员) `.

• v0.5 – Encompass MCP 컴패니언(LOS 읽기/쓰기). DocuSign MCP 컴패니언. 한 번의 프롬프트로 CRM + 이메일 + 캘린더 + 견적 + 라이브러리가 연결.

기여하기

이슈와 PR을 환영합니다. 아래 로드맵이 우선순위이며, 어떤 작업을 나가는 맡을 경우 먼저 이슈를 열어 서로 조정되지 않도록 하unding 있시기 조정.

연락처

Chris Black · NMLS 275073 · chris@askcal.io