Hmda

HMDA — 美国抵押贷款申请（贷款级别）

美国贷款机构根据《住房抵押贷款信息披露法》必须披露的所有抵押贷款申请，涵盖 2018–2025 年：申请人是谁、结果如何、贷款金额是多少，以及贷款机构、县和人口普查区。每条记录约有 99 个字段。

这是 Pipeworx 的一部分——一个将 AI Agent 连接到 1881+ 个实时数据源的 MCP 网关。这是一项独立的非官方集成，与上游提供方无关联、未经其认可，也并非由其发布。

这是公平信贷分析所依据的数据集——它的存在是为了让不同种族、族裔、性别和地区之间的拒贷模式能够接受核查，而不是仅仅被宣称存在。

身份验证

无需身份验证。 CFPB/FFIEC Data Browser API 是公开的，无需密钥。

工具

工具	适用场景
hmda_lender_activity	你有贷款机构的 LEI，想查询其年度数据
hmda_geography_activity	你想查询某个县或州，也可以按种族、族裔、性别、用途或贷款类型拆分
hmda_loan_records	你需要单笔申请，而不是汇总数据
hmda_lenders_in_county	你想了解这里有哪些贷款机构，并按排名查看

贷款机构通过 LEI 而非名称识别——resolve_entity({type:"company"}) 可以将名称映射到 LEI。县使用 5 位 FIPS 代码（06037，而不是“洛杉矶”）。

为什么无需导入数据

此工具包最初按批量加载方案设计：每年约 1500 万条记录、12–18 GB 的 Postgres 数据、R2/Postgres 列拆分，以及可能需要升级数据库层级。

这些都不需要。Data Browser API 无需密钥即可直接响应反向查询——view/aggregations 可按你传入的任意维度分组，view/csv 可流式传输贷款级别的行——因此该工具包代理实时数据，不托管任何数据。测量日期：2026-08-25。

工单中提到的阻碍是：ffiec.cfpb.gov/static/prod/snapshot-data/… 返回 HTTP 200，但内容是一个 3 KB 的 SPA 外壳页面；S3 路径则返回 403。这两点都属实，但都无关紧要：批量文件并非数据接口。API 文档见 /documentation/api/data-browser/。

值得提醒用户的注意事项

• HMDA 是一项披露制度，并非贷款业务普查。 未达到报告门槛的机构不会出现在数据中。某个贷款机构未出现在某年度数据中，表示它没有提交报告；这不等同于它没有发放贷款。
• 拒贷原因是贷款机构编码的原因，不是经过裁定确认的结论。这些数据有助于探究不同群体之间的模式是否存在差异；但仅凭这些数据无法确定原因。
• 美元贷款量是贷款金额之和，不是未偿还余额。
• 贷款机构身份是上游筛选条件，而非分组维度。 你可以查询某个贷款机构在某县的业务情况；但 API 无法按县对贷款机构排名。hmda_lenders_in_county 通过直接读取该县的记录来实现这一功能，但受数据量限制——超大县会采用抽样，响应中会注明这一点。要获得完整排名，需要预先计算按贷款机构和县汇总的数据（每年约 775,000 行，数十 MB）；本工具包有意不包含这些数据。

数据来源

CFPB / FFIEC HMDA Data Browser API — https://ffiec.cfpb.gov/v2/data-browser-api/。 属于公有领域，是美国联邦政府作品。

快速开始

将其添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "hmda": {
      "url": "https://gateway.pipeworx.io/hmda/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/hmda/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、discover_tools、search_within、remember/recall 和网关范围内的其他工具。因此，你看到的工具数量会多于表中的数量：目前，单个工具包端点除了列出该工具包自身的工具，还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，是当天情况的权威依据。

这是有意为之，并非意外的多路复用。元工具可以让受限范围的连接回答此工具包未覆盖的问题——通过 ask_pipeworx 在整个目录中路由——而无需你再添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构定义占用的上下文比路由功能带来的收益更大，请改为只连接一次完整网关，而不是连接多个工具包端点。

或者连接完整的 Pipeworx 网关，直接列出每个工具包的工具，而不只是这个工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和相同的 1881+ 个数据源。唯一的区别是直接列出哪个工具包的工具；从任一端点都可以通过 ask_pipeworx 访问所有工具包。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/hmda_lender_activity \
  -H 'Content-Type: application/json' \
  -d '{"lei":"549300FGXN1K3HLB1R50","year":2023,"county":"11001"}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/hmda_lender_activity。查找工具：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账户）

此软件包也可作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需往返网关：

{
  "mcpServers": {
    "hmda": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-hmda"]
    }
  }
}

或者直接运行它，确认能够启动：

npx -y @pipeworx/mcp-hmda

它通过 stdin/stdout 使用 MCP 通信，并针对仅限此工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接添加的任何共享元工具。来源相同，工具相同，但没有 ask_pipeworx 路由功能。

使用 ask_pipeworx

你可以用通俗易懂的英语提问，而不是直接调用工具——这既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Hmda data" })

网关会选择合适的工具，并自动填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT