Fema Nfhl

@pipeworx/fema-nfhl

FEMA の National Flood Hazard Layer — 権威あるデジタル洪水マップです。 有効な FIRM 洪水ハザードゾーン、基本洪水標高、洪水路、堤防、 横断面、LOMR および LOMA、FIRM パネル索引、行政区画を、公開 ArcGIS REST MapServer として提供します。

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

ツール

• nfhl_flood_zone_at_point(latitude, longitude, include_bfe?) — 座標地点の有効な FIRM 洪水ゾーン：ゾーンコードとサブタイプ、特別洪水ハザードエリアのフラグ、 静的 BFE、適用される DFIRM ID、および近隣の BFE 線です。
• nfhl_query(layer_id, where?, bbox?, out_fields?, limit?, offset?, order_by?, return_geometry?) — WHERE 句と任意のエンベロープを指定して、NFHL の任意のレイヤーを検索します。
• nfhl_layers(filter?) — すべてのレイヤーと、重要なレイヤーについての平易な説明です。

認証

不要です。

データソース

• https://hazards.fema.gov/arcgis/rest/services/public/NFHL/MapServer — MapServer です。
• レイヤー 28 S_FLD_HAZ_AR（洪水ハザードゾーン）、27 S_FLD_HAZ_LN（境界 線）、16 S_BFE、1 S_LOMR、34 S_LOMA、3 S_FIRM_PAN、23 S_LEVEE、 0 NFHL Availability です。

openfema パックとは別の API です。 openfema は OpenFEMA の 表形式データセット（災害宣言、個人および公共支援、NFIP の請求と保険契約）を提供します。 このパックが提供するのは地理空間の洪水マップであり、OpenFEMA では回答できません。 両方を組み合わせてください。ゾーンの確認には NFHL を、対象地域の郡における請求と 災害宣言の履歴には openfema を使います。

注意点

• STATIC_BFE は基本洪水標高が適用されない場合、-9999 になります。これは標高ではなく、 番兵値です。このパックでは null を返します。
• SFHA_TF（文字列の 'T'／'F'）が、「ここは特別洪水ハザードエリアか」という問いへの答えです。 FLD_ZONE だけでは判断できません。Zone X には 2 つのサブタイプがあり、 そのうち 1 つは年間発生確率 0.2％（500 年に 1 度）の氾濫原です。
• NFHL のカバー範囲は全国ではありません。 デジタルマップが一度も作成されていない地域では、 フィーチャーが 0 件返されます。これは「マップ未作成」を意味し、「洪水リスクなし」ではありません。 nfhl_flood_zone_at_point は、問題なく安全だと誤解される空の配列を返す代わりに、 その旨を明示します。レイヤー 0（NFHL Availability）で、どちらに該当するか確認できます。
• 識別子フィールドは文字列です。48201C ではなく DFIRM_ID='48201C' です。

クイックスタート

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

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

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

https://gateway.pipeworx.io/fema-nfhl/mcp の tools/list は、上の表にあるツールに 加えて、共有 Pipeworx メタツール（ask_pipeworx、discover_tools、 search_within、remember／recall など、ゲートウェイ全体で利用できるツール一式）も返します。 そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、 そのパック固有のツールに加えて共有ツールがおよそ 30 個表示されます。接続の initialize 応答に 正確なスコープが記載されており、その日の状況を確認するための正式な情報源です。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使うと、このパックの対象外の質問にも、 カタログ全体を横断して振り分ける ask_pipeworx 経由で回答できます。そのため、MCP サーバーを もう 1 つ追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントを マウントする方法はありません。追加のスキーマによって得られる利便性よりもコンテキスト消費のほうが大きい場合は、 複数のパックエンドポイントに接続するのではなく、ゲートウェイ全体に一度接続してください。

このパックだけでなく、すべてのパックのツールを直接一覧表示するには、Pipeworx ゲートウェイ全体に接続します。

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

どちらの URL も、同じゲートウェイと同じ 1879 以上のデータソースに接続します。 唯一の違いは、どのパックのツールが直接一覧表示されるかです。どちらからでも、 ask_pipeworx ですべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/nfhl_flood_zone_at_point \
  -H 'Content-Type: application/json' \
  -d '{"latitude":29.7604,"longitude":-95.3698}'

最初の呼び出しにアカウントは必要ありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/nfhl_flood_zone_at_point を使います。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使います。

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

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントもゲートウェイへの往復通信も不要です。

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

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-fema-nfhl

stdin/stdout 経由で MCP を使用し、initialize／tools/list／tools/call に応答します。対象はこのパックのツールのみです。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールを使い、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントでも、ゲートウェイ全体でも使えます。

ask_pipeworx({ question: "your question about Fema Nfhl data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT