Hud

HUD — 住宅都市開発省

米国住宅都市開発省のデータです。公正市場家賃（FMR）、所得制限、USPS空室データ、公営住宅の特性、Continuum of Care（ホームレスデータ）、包括的住宅アフォーダビリティ戦略（CHAS）データを提供します。無料で、認証は不要です。

Pipeworxの一部です。AI エージェントを1881以上のライブデータソースに接続するMCPゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携しておらず、承認も公開もされていません。

AI エージェントにとって重要な理由

住宅のアフォーダビリティ分析、連邦政府の給付基準、ホームレス支援サービスの調査には、HUDが情報源となります。Census（住宅特性）、Altos（リアルタイムの市場データ）、ATTOM（物件単位のデータ）、FRED（住宅ローン・マクロ経済の背景情報）と組み合わせてください。

よくある利用方法：

• 公正市場家賃。「デンバーの寝室2部屋の住宅に対するHUDのFMRはいくらですか？」— FMRデータはSection 8バウチャーの金額を決定します。
• 所得制限。「ボストンの4人家族の所得中央値はいくらですか？」— 住宅プログラムの利用資格の判断に使われます。
• USPS空室データ。「このZIPの住宅戸数のうち、空室の割合は何％ですか？」— 四半期ごとに、国勢調査区単位のUSPS由来の空室率を確認できます。
• **ホームレス状況。**ある時点での人数調査、人口統計の内訳、Continuum of Careのレポート。
• **公営住宅。**住宅当局の一覧、住戸数、対象となる人口統計。

認証

HUD 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月下旬のある夜に人数調査を行います。方法はContinuum of Careごとに異なり、特にシェルターを利用していない人の数は見落とされやすいため、下限値として扱ってください。
• **CHASデータは5年間の平滑化データです。**ACSの5年データと同様に、直近5年間を反映したデータです。住宅のアフォーダビリティのリアルタイムな変化を把握するには、より頻度の高い指標を組み合わせてください。
• **CBSAと郡のFMRの違い。**HUDが公表するFMRはCBSA（大都市圏・小都市圏）単位です。特定の郡の実際の家賃は、その郡が属するCBSAのFMR平均と大きく異なる場合があります。

クイックスタート

MCPクライアント（Claude Desktop、Cursor、Windsurfなど）に追加します。

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

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/hud/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/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":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの 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