用途
这是一套通过 MCP（模型上下文协议）为 AI 智能体提供美国房地产债务与房产地块数据查询的服务，由 Capital-W-Holdings 发布。其核心目标是让智能体能够回答带日期的具体问题：谁拥有某栋建筑、它最近以什么价格售出、哪些贷款和补贴会在给定的州和时间窗口内到期，并且每一条结论都附带数据来源和观测日期。
主要能力
房地产域包含两类几乎不重叠的数据群体：
美国商业与联邦项目房地产债务：覆盖 52 个州代码的贷款到期数据、56 个州代码的合规到期数据和 54 个州代码的补贴到期数据。官方文本明确列出 19,821 笔 FHA 和 CMBS 贷款、11,956 个 LIHTC 结束、4,721 个 HUD 到期。所有贷款均带有 maturity_basis = 'confirmed'，即日期来自贷款服务商向 SEC 提交的文件或 HUD 记录，并解析到具体建筑，没有一笔是估算或按期限推断的。
房产记录：292,039 条马萨诸塞州和纽约州地块携带所有权与评估价值，95,562 份已登记销售文书覆盖哥伦比亚特区、马萨诸塞州和纽约州。
同一条连接还覆盖另外三个 DFX 图谱：家族办公室（2,559 个办公室、4,238 个基金会、748 个持有 13F 头寸的办公室、394 个有已观测直接投资的办公室）、独立发起人（4,167 个发起人、10,660 个资本提供方、97,287 家私营公司，其中 17,064 家带转型信号，317,710 个计算出的公司到发起人匹配、2,397 笔已宣布交易）、风险投资（76,936 只基金、113,590 人、47,455 家公司、30,805 轮次）。四个图谱使用同一套 id 方案、同一套响应契约，仅通过共享的 CRD、CIK 或 EIN 做跨图身份关联；同名实体会作为候选返回，绝不合并。
使用方式
端点：https://exchange-production-9123.up.railway.app/mcp
传输方式：Streamable HTTP
认证：无
注册表：io.github.Capital-W-Holdings/us-property-parcel-real-estate-debt
对端点做普通 GET 即可返回完整工具列表、覆盖数字和一个可运行示例，无需握手、会话或 initialize。随后通过 JSON-RPC 调用具体工具。102 个工具全部免费、未认证、只读：不需要密钥、注册或 OAuth。若客户端只支持 stdio，可使用 bridge/dfx_mcp_stdio.py 桥接，该文件仅依赖标准库、无密钥、无状态，使用时需给出绝对路径。
官方文档建议先阅读 schema 再调用，并推荐从 what_can_dfx_answer 开始；该工具会明确说“不”，并记录提问，从而让 DFX 无法回答的问题影响后续构建方向。服务器还会以附带的词表拒绝未知参数。
常用工具：dfx_coverage 在调用时返回覆盖网格；debt_maturity_schedule 针对某个州和一个前向窗口返回最多 200 笔贷款，每笔一行，按到期日排序，包含本金、利率、放款人、担保房产和来源字段；search_property_events 返回事件（日期、标题、地址）；get_property_record 可触达没有单一州归属的贷款；search_entities、get_entity、search_people、search_relationships、relationship_path、search_events、verify 以及经济工具 find_capital_for_opportunity、find_opportunities_for_capital、explain_match、why_now、who_should_care；changes_since 基于游标，按 DFX 得知事实的时间排序。
适用场景
- 查询某个州未来 548 天内到期的商业抵押贷款、放款人及对应建筑。
- 查询 LIHTC 合规期和 HUD 补贴合同在何处、何时到期。
- 查询某地块上次售价、买方以及登记簿册和页码。
- 查询某栋建筑的所有者、管理者或贷款方。
- 跨家族办公室、独立发起人和风险投资图谱做实体检索、关系路径追溯和匹配解释。
限制
官方文本明确列出多项覆盖不均与限制：
- 覆盖范围有意不均且提前声明：贷款到期覆盖仅为联邦项目贷款（FHA 保险和机构支持），县契约登记处不向自动化开放，传统融资的房产在此没有债务记录；某房产未出现在到期搜索中并不等于该房产没有债务。
- 马萨诸塞州专属：地块和所有权。已登记销售：马萨诸塞州全州，加上纽约市 1000 万美元及以上的契约。波士顿专属：许可和占用证书。
- LIHTC 合规期是法定的，全部落在 12 月 31 日，因此按日分桶会出现 12 月的悬崖，这是法条产物而非市场事件。
- 该图谱中任何预测都从未观测到结果；所有内容都不携带校准概率，每个分数都是排序信号。
- 一个街道地址可能携带多条记录：在 6,114 个此类聚类中，2,764 个单元数一致、3,350 个单元数不同。DFX 未合并其中任何一个，
resolve()会说明属于哪种情况。 - 房产记录和地块是几乎不重叠的两个群体，约各 100,000 条中只有 661 对干净的一对一配对。
- 房产记录并非每栋建筑一行：101,991 条已发布房产记录覆盖 94,859 个不同规范化地址，跨它们计算总数会高估约 8%；每条记录携带 address_group_size，便于去重。
- 销售数据来自两个粒度不同的来源：马萨诸塞州是评估名册（全州、每地块一笔销售、买方具名、卖方从不具名，因此无法推导重复销售对和持有期），纽约是登记处摘录（五个行政区、双方具名、每份文书都有日期，因此可推导重复销售和持有期，但仅限 1000 万美元及以上的契约）。两者都不是全国销售数据。
- 145 笔贷款没有单一州归属，无法通过州过滤触达，需通过
get_property_record获取。 - 联系点在所有图谱上均不通过 MCP 提供。
- 官方文本中部分风险投资字段显示为 None（如基金数量、有近期募资的机构数、已填充行业的机构数），具体含义暂未提供。
页面数据标注为 2026-09-30 测量，并建议调用 dfx_coverage 获取阅读时刻的同一网格。
