Fed Nic

@pipeworx/fed-nic

米国の銀行および銀行・金融持株会社の機関検索、企業所有階層、合併・買収履歴を提供します。情報源は、連邦準備制度の National Information Center（NIC、ffiec.gov/npw）です。

Pipeworx の一部です。AI エージェントを 1879 以上の稼働中データソースに接続する MCP ゲートウェイです。独立した非公式の連携であり、上流プロバイダーとは提携、承認、公開のいずれの関係もありません。

ツール

• nic_search_institutions(query, status?, state?, limit?) — 機関を名称で検索します。 RSSD ID、FDIC 証明書、LEI、機関種別、所在地、営業中／閉鎖のステータスを返します。nic_search_ranked（マイグレーション 212）による順位付けを行います。完全一致、営業中の FDIC 証明書を持つ機関の前方一致、その他の前方一致、その他の営業中の FDIC 証明書を持つ機関、残りの順です。アルファベット順ではありません（「対象範囲／精度に関する注記」を参照）。
• nic_get_institution(rssd_id? | fdic_cert? | lei?) — 1 つの機関の NIC レコード全体を取得します。RSSD ID、FDIC 証明書番号（fdic パックに連携）、LEI（gleif パックに連携）のいずれか 1 つを指定して検索します。
• nic_get_hierarchy(rssd_id, direction?, limit?, offset?) — direction="up" （デフォルト）では所有関係をたどり、最上位の持株会社まで遡ります（「この銀行を所有する持株会社はどれですか？」）。direction="down" では、指定した RSSD ID が所有する事業体を一覧表示します。limit／offset でページ分割し、total_subsidiary_count は SQL の DISTINCT 件数として計算されます（マイグレーション 212 の nic_descendant_count）。以前の件数が誤っていた理由については、「対象範囲／精度に関する注記」を参照してください。
• nic_get_history(rssd_id) — 機関が関与した合併、買収、破綻、組織変更を取得します（「どの前身機関がこの銀行に統合されましたか？」）。

認証

キー不要です。呼び出し側が提示する認証情報はありません。ゲートウェイがストアの認証情報を自動的に提供します。

データソース

• https://www.ffiec.gov/npw/FinancialReport/DataDownload — NIC の公開バルク CSV ファイル：Attributes-Active、Attributes-Closed、Relationships、Transformations。米国連邦政府のデータです。ダウンロードページまたは NPW サイトには再利用制限が見当たりません（連邦政府データはデフォルトでパブリックドメインです。「再利用条件」を参照）。

このパックがライブプロキシではなくミラーからデータを読み取る理由

www.ffiec.gov は Cloudflare Managed Challenge （cf-mitigated: challenge）の背後にあり、ブラウザー以外のすべての HTTP クライアントに対し、「CAPTCHA Error」ページを含む 403 を返します。これは以下の両方で確認されています。

• ライブサイト自体がクエリごとに使用するインタラクティブな NPW ページ （Institution/Profile/{rssd_id}、POST Institution/BuildTier、POST Institution/LoadHistory）
• バルク CSV のダウンロードエンドポイント （FinancialReport/Return*ZipFileCSV）

Chrome のヘッダー一式（User-Agent、Accept、Accept-Language、 sec-ch-ua*）を指定しても同じです。Cloudflare Worker の fetch() でも同じ壁に当たります。ヘッダーや Cookie で解決する方法はありません。これは UA のチェックではなく、JS/TLS フィンガープリントによるチャレンジです。そのため、このゲートウェイが到達できるライブのクエリ単位の経路はありません。Bruce の 2026-09-23 の裁定（「ライブで提供されない場合はコピーを作成する」）に従い、このパックは代わりに、NIC が公開するバルクファイルの定期更新コピーを使用します（マイグレーション supabase/migrations/209_fed_nic.sql）。更新は scripts/ingest-fed-nic.mjs が行います。更新を Worker cron で実行できない正確な理由と、手動実行に必要なものについては、このスクリプトのヘッダーを参照してください。これは鮮度の確認のみを目的として workers/data-pipeline/src/datasets/fed-nic.ts に登録されており、スケジュール実行はありません。workers/data-pipeline/src/datasets/ffiec.ts が cdr.ffiec.gov に使用しているものと同じパターンです。

再利用条件

NIC の Data Download ページ（/npw/FinancialReport/DataDownload、「About the Files」）には、ファイルの内容と使用方法が記載されていますが、著作権、ライセンス、再利用の制限については記載されていません。このページからリンクされている NIC Data Dictionary PDF は、ffiec.gov の他のページと同じ Cloudflare のブロックの背後にあり、直接確認できませんでした。これは、監督・規制機能に関して米国連邦機関（Federal Reserve System）が作成したデータです。反対の通知がない限り、米国連邦政府の著作物はデフォルトでパブリックドメインとなります（17 U.S.C. § 105）。そのような通知は見つかりませんでした。

対象範囲／精度に関する注記

• 支店データは取り込んでいません。 NIC の Attributes-Branches ファイル（約 17.4 万行、95MB）は、このパックが対象とする階層／履歴のユースケースの範囲外です。NIC UI の「Branches」タブで確認でき、後から追加することもできます。
• nic_get_hierarchy は独自に算出した推移閉包であり、NIC 独自の階層化アルゴリズムの複製ではありません。 NIC の公開 Relationships ファイル内の現在有効な（dt_end IS NULL）エッジを再帰的にたどります。2026-09-23 に JPMorgan Chase Bank, N.A.（RSSD 852218）を対象に実データで確認したところ、direction="up" はライブ UI と完全に一致しました（最上位の持株会社は JPMorgan Chase & Co.、RSSD 1039502）。一方、最上位階層からの direction="down" では、当方の推移閉包で877社、ライブ UI では1,025社が返されました。この差異は公開バルクファイルだけでは再構成できません（ライブ UI の階層化アルゴリズムでは、公開 Relationships エクスポートに完全には含まれないルール（例：持分以外の支配関係、支店／代理店関係）が適用されている可能性があります）。下方向の件数は NIC が公開したデータから算出した下限値として扱い、NIC の公式数値とはみなさないでください。 マイグレーション 212 では、877 という値がツールに渡されるまでの別のバグを修正しています。 Relationships の推移閉包は、子会社ごとに1行ではなく、所有経路ごとに1行を出力します。そのため、複数の親会社経由で到達可能な子会社は重複して現れます（JPMorgan の場合、結果は生の行で1,672行、重複を除いた RSSD ID で877件）。ツールは当初、生の推移閉包 RPC を直接呼び出し、返された行数を total_subsidiary_count として使用していました。PostgREST は1回の RPC 応答を1,000行に制限するため、生の推移閉包がこの上限を超えると、件数は誤って1,000になっていました。nic_descendant_count（行数制限の影響を受けない単一行のスカラー値）と nic_descendants_page（SQL 内で重複を除去してページ分割）でこの問題を修正しています。詳しくは src/index.ts 冒頭のコメントと supabase/migrations/212_fed_nic_hierarchy_and_search_fix.sql を参照してください。
• nic_search_institutions のランキング（マイグレーション 212、nic_search_ranked）。 単純なアルファベット順では、同じ系列の中で、多くの呼び出し元が求める機関よりも別の機関が先に表示されていました。たとえば、クエリ「Wells Fargo Bank」では、ASCII で ' ' が ',' より前に並ぶため、FDIC 証明書を持たないアイルランド法人「WELLS FARGO BANK INTERNATIONAL UNLIMITED COMPANY」が、「WELLS FARGO BANK, NATIONAL ASSOCIATION」（RSSD 451965）より先に返されていました。現在は、完全一致、FDIC 証明書を持つ前方一致、その他の前方一致、証明書を持つその他の有効な機関、その他の順にランク付けされます。各階層内で同順位の場合は、legal_name が最も短いもの（クエリの長さに最も近いもの）、次にトライグラム類似度で順位を決めます。
• entity_type_code のラベルは一部のみです。 src/index.ts の ENTITY_TYPE_LABELS には、NIC UI で実データを確認したコード（NAT、FHD、EDI、IBK、INB、DEO）のみが含まれています。それ以外のコードは推測せず、そのまま返します。残りのコードを確認できる NIC Data Dictionary 自体が Cloudflare のブロックの背後にあるためです。
• trnsfm_cd（変換タイプ）は、同じ理由でラベルではなく NIC の生コードです。 コード 50 は、実例（First Republic Bank、RSSD 4114567 → JPMorgan Chase Bank N.A.、RSSD 852218、2023-05-01。ライブ NIC History タブでは「failed and ceased to exist」）を使って裏付けています。

クイックスタート

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

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

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

https://gateway.pipeworx.io/fed-nic/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/nic_search_institutions \
  -H 'Content-Type: application/json' \
  -d '{"query":"JPMorgan Chase Bank"}'

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

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

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

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

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

npx -y @pipeworx/mcp-fed-nic

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

ask_pipeworx を使う

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

ask_pipeworx({ question: "your question about Fed Nic data" })

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

詳細情報

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

ライセンス

MIT