API reference
Read endpoints are public; write and trigger endpoints require WRITE_SECRET. Responses stamp model_version, and accuracy is published at /methodology/accuracy.
Spec version p0a-2026.07 · endpoint table generated 2026-07-10 frompackages/spec/openapi.yaml · base URL https://chicago-value-map.mohammad210.workers.dev
| Method | Path | Summary |
|---|---|---|
GET | /api/health | Service + data freshness |
GET | /api/tracts/{metro} | All tract metrics for a metro (free read:tracts tier) |
GET | /api/listings/{metro} | Active scored listings (top 200 by deal score, deduped by address) |
GET | /api/underwrite | Full underwrite at a point (live comps + risk + economics) |
GET | /api/metrics/scorecard | Published accuracy scorecard (the /methodology/accuracy source) |
GET | /api/mcp-tools | MCP tool catalog (names, descriptions, schemas) — docs generator source |
GET | /api/state | Personal UI state (WRITE_SECRET required) |
PUT | /api/state | Personal UI state (WRITE_SECRET required) |
GET | /api/deals | Deal ledger (WRITE_SECRET required) |
POST | /api/deals | Deal ledger upsert (WRITE_SECRET required) |
GET | /api/run-listings | Trigger listings run (WRITE_SECRET required; modes: daily|sweep|rescore) |
POST | /mcp | MCP server (streamable HTTP JSON-RPC). PUBLIC BETA — no auth, 30 calls/min/IP. OAuth 2.1 (F2) adds keys/scopes. |
Interactive explorer
Loading the interactive API explorer…