Hud

HUD — 住房与城市发展部

美国住房与城市发展部的数据。公平市场租金（FMR）、收入限额、USPS 空置数据、公共住房特征、无家可归者连续照护（Continuum of Care）数据、综合住房可负担性策略（CHAS）数据。免费，无需身份验证。

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

这对 AI Agent 的意义

对于住房可负担性分析、联邦福利门槛或无家可归者服务研究，HUD 是权威来源。可搭配 Census（住房特征）、Altos（实时市场数据）、ATTOM（房产级数据）和 FRED（抵押贷款／宏观背景）使用。

常见工作流：

• 公平市场租金。“HUD 对丹佛一套两居室的 FMR 是多少？”——FMR 数据决定 Section 8 住房券金额。
• 收入限额。“波士顿四口之家的收入中位数是多少？”——用于确定住房项目的资格。
• USPS 空置数据。“这个 ZIP 中有多少比例的住房单元处于空置状态？”——基于 USPS 数据，按普查区提供季度空置率。
• **无家可归情况。**时间点统计、人口统计细分、无家可归者连续照护报告。
• **公共住房。**住房管理机构列表、单元数量、服务对象的人口特征。

身份验证

大多数 HUD API 免费且无需身份验证。少数 API 需要注册以获取免费令牌。Pipeworx 在适用时支持传递 _apiKey。

值得了解的数据集

数据集	更新频率	用途
公平市场租金（FMR）	每年（10 月 1 日生效）	住房券补贴水平、租房可负担性
收入限额	每年（4 月）	Section 8 资格、LIHTC 资格认定
USPS 空置数据	每季度	按普查区划分的空置率
AHAR（年度无家可归情况报告）	每年	无家可归人数、人口统计数据
CHAS	5 年	住房成本负担的详细统计
PIH（公共住房）	持续更新	公共住房管理机构数据

常见问题

• **FMR 与市场租金不同。**公平市场租金是 HUD 用于确定住房券报销金额的政策数值，并非市场实际租金——通常比真实市场租金滞后 6-18 个月。要了解市场实际情况，请使用 Altos 或租房聚合平台数据。
• AMI 因家庭人数而异。“AMI 的 80%”取决于家庭有 1、2、3 人还是 4 人以上。仅看“收入中位数”这一概括性数据无法体现这一点。
• **USPS 空置率并非真实空置率。**USPS 空置数据统计的是邮递员标记为空置 90 天以上的单元，可能低估短期空置，并高估止赎房产。
• **无家可归者时间点统计存在漏计。**大多数司法辖区会在 1 月下旬的某个夜晚进行 PIT 统计。各无家可归者连续照护机构的统计方法不一，尤其容易漏掉无住所者。应将其视为下限估值。
• **CHAS 数据经过 5 年平滑处理。**与 ACS 5 年数据类似，数据反映的是滚动 5 年期间的情况。要了解住房可负担性变化的实时情况，应结合更新更快的信号。
• **CBSA 与县级 FMR。**HUD 按 CBSA（大都市区／小都市区）发布 FMR。具体县的实际租金可能与所在 CBSA 的 FMR 平均值大相径庭。

快速开始

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

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

此端点实际提供的内容

tools/list 在 https://gateway.pipeworx.io/hud/mcp 返回上表中的工具，以及共享的 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/hud_fair_market_rents \
  -H 'Content-Type: application/json' \
  -d '{"state_code":"CA"}'

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

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

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

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

或者，直接运行以确认它可以启动：

npx -y @pipeworx/mcp-hud

它通过 stdin/stdout 使用 MCP 通信，并响应 initialize/tools/list/tools/call，但仅提供此工具包的工具——不包含上文网关连接额外提供的任何共享元工具。数据源相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗语言提问，而不是直接调用工具——此方式既适用于上文的工具包端点，也适用于完整网关：

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

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT