mcpField
N
Ncua

Ncua

リモート
pipeworx.io金融データ01 日前に更新
リポジトリ公式サイト

Ncua について

Ncuaは、NCUAの四半期5300 Call Reportに基づき、米国の連邦保険対象信用組合データを照会するMCPサーバーです。ラベル付き財務項目、過去の報告、支店・ATM情報を使った調査や比較に対応します。

主な機能

  1. 01信用組合の検索と概要表示
  2. 02四半期ごとの財務数値の照会
  3. 03機関の順位付けと比較
  4. 04Call Reportの勘定コードをラベルに変換
  5. 05支店とATMの所在地検索

活用シーン

  1. 01資産や会員数による信用組合の比較
  2. 02四半期ごとの報告値の追跡
  3. 03信用組合や地域から支店を検索

MCP 対応

Pipeworx経由またはローカルstdio MCPサーバーとして、信用組合の検索、財務、比較、勘定コード、支店に関するツールをMCPクライアントに公開します。ゲートウェイ接続にはPipeworx共通のメタツールも含まれます。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://gateway.pipeworx.io/ncua/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

ツール

詳細

NCUA — 米国の信用組合(5300 Call Report)

連邦保険の対象となる米国内すべての信用組合の財務、会員数、支店、ATMの情報です。規制当局独自の5300 Call Reportに基づき、4,336機関の四半期報告書を過去5年分収録しています。

Pipeworx の一部です。AI エージェントを1683以上の稼働中データソースにつなぐMCPゲートウェイです。

fdic と併存する理由

両者は米国のリテールバンキングをそれぞれ異なる範囲でカバーしており、どちらも相手の範囲には回答できません。信用組合はFDICではなくNCUSIFの保険対象であるため、定義上、FDICのデータには含まれません。欠落や不完全さの問題ではなく、構造上存在しないのです。「自分の銀行の規模はどのくらいか」と「自分の信用組合の規模はどのくらいか」は、別々に検索する必要があります。

banking-regulations はさらに別のものです。このパックはNCUAの 規則(12 CFR 700–799)を提供します。こちらは機関の情報を提供します。

ツール

ツール回答できる質問
ncua_search_credit_unionsテキサス州オースティンの信用組合 — 名称、都市、州をあいまい検索
ncua_credit_union_profileNavy Federalの規模は? — 資産、会員数、ローン、預金、支店
ncua_credit_union_financials時系列での単一項目、または四半期の全項目
ncua_rank_credit_unionsオハイオ州で最大の信用組合 — ミラー対象の任意の項目で順位付け
ncua_compare_credit_unions2~5組合を並べて比較
ncua_account_lookupACCT_010とは? — 3,376項目を収録した勘定科目辞書全体
ncua_branches信用組合または地域別の支店とATMの所在地
ncua_industry_totals信用組合はいくつある? — 全国または州別

認証

不要です。

勘定科目辞書が本体です

5300 Call Reportでは、すべての数値が不透明なコードにひも付けられており、その意味は別ファイルに記載されています。

FS220.txt : CU_NUMBER, CYCLE_DATE, ACCT_010, ACCT_083, ...
            1,         3/31/2026,  13376472, 7678,     ...

AcctDesc  : ACCT_010 -> "TOTAL ASSETS"
            ACCT_083 -> "Number of current members (not number of accounts)"

ACCT_010: 13376472 だけでは答えになりません。値を返すすべてのツールは辞書を結合し、ラベルも併せて返します。また、ncua_account_lookup は、定義はあるものの報告値がない3,179項目も含め、任意のコードを解決します。

ミラー対象と対象外

NCUA自身がFinancial Performance Reportとして指定する197項目を保存しています。これは当方の選定ではなく、NCUAによる選定です。四半期あたり約16万5,000件のゼロ以外の値があります。全3,376項目を対象にすると、四半期あたり133万件となり、誰も求めていない利用頻度の低い項目群のために、ストレージが8倍必要になります。

辞書全体はどちらにしてもミラーされるため、値を保持していない項目も不明ではなく、説明可能です。そのような項目については、ncua_account_lookup が mirrored_values: false を返します。

四半期20(2021-06 .. 2026-03)
値384万件
支店 / ATM22,829 / 17,588 — 現四半期のみ
データ容量692 MB(うち440 MBはインデックス)

ミラーである理由

NCUAはAPIを公開していません。ncua.gov/api/* は404を返します。また、Credit Union Locatorである mapping.ncua.gov は、すべてのパスに同じHTMLを返すAngularアプリです。これはクライアント側UIであり、エンドポイントではありません。機械可読な形式は、26ファイルからなる約7.7 MBの圧縮済み四半期一括アーカイブのみです。

取り込み処理:workers/data-pipeline/src/datasets/ncua.ts(定期実行)および scripts/ingest-ncua.mjs(過去データの取り込みと単発修復)。スキーマ:supabase/migrations/071_ncua.sql。

データソース

次の人が改めて発見することになる情報
  • 同じファイルに3種類のURL規則があります。 call-report-data-2016-03.zip(現在)、Call-Report-Data-2015-06.zip(大文字始まり)、さらに古いものは /files/publications/data-apps/ 配下の QCR201406.zip です。現在の規則しか知らないリゾルバーでは、履歴が2016年から始まってしまいます。
  • 公開には約56日の遅れがあります。 2026-03-31のサイクルには2026-05-26の日付が付いていました。そのため、現在の暦四半期のデータが最新とは限りません。鮮度のSLAはこの理由から200日です。これより厳しい基準では、毎サイクル誤って失敗します。
  • すべての勘定科目コードが ACCT_ で始まるわけではありません。 NCUAの多様性に関するフィールドは BOARDBLACKAMERICAN、CURMEMHISPANICAMERICAN、FOMMINORITYSTATUS です。列を /^ACCT_/ でフィルタリングすると、一見問題ないように見えても、該当する15項目がすべて除外され、マイノリティ預金取扱機関のデータセット全体が欠落します。
  • データの91%はスパースですが、ゼロは実際の値です。 FS220K.txt は、一部の四半期では全項目がゼロです。これはデータソースの内容なので、nullに変換しないでください。
  • 信用組合が見つからないのは、合併または清算されたためです。 件数は四半期ごとに減少しています(2021年の5,136件から現在は4,336件)。チャーター番号で検索して結果が空でも、その番号が無効というわけではありません。
  • CU_NUMBER はNCUAのチャーター番号であり、RSSD ではありません。 どちらも含まれています。RSSD はFed/FFIECデータとの結合キーです。
  • net_income(ACCT_602)を報告している信用組合は半数未満です。 NCUAが報告を求めるのは、その金額が未配分利益にすでに含まれていない場合に限られます。そのフィールドのnullは、収入がゼロという意味ではなく、報告規則によるものであり、レスポンスにもその旨が示されます。
  • 座標はありません。 NCUAは緯度・経度なしで支店住所を公開しているため、位置検索は市区町村/州/ZIPコードのテキスト照合です。「近くの場所」を案内できるとうたわないでください。

クイックスタート

MCP クライアント(Claude Desktop、Cursor、Windsurf など)に追加します:

{
  "mcpServers": {
    "ncua": {
      "url": "https://gateway.pipeworx.io/ncua/mcp"
    }
  }
}
このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/ncua/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も同じゲートウェイと、同じ1,683以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使えばすべてのツールにアクセスできます。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/ncua_search_credit_unions \
  -H 'Content-Type: application/json' \
  -d '{"name":"navy federal"}'

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

スタンドアロン(ゲートウェイアカウント不要)

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

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

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

npx -y @pipeworx/mcp-ncua

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

ask_pipeworx での使用

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

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

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

詳細

ライセンス

MIT

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。