Ncua

NCUA — 美国信用合作社（5300 Call Report）

所有联邦保险承保的美国信用合作社的财务、会员、分支机构和 ATM 数据——4,336 家机构，涵盖五年的季度申报数据，来源为监管机构自己的 5300 Call Report。

属于 Pipeworx 的一部分——一个连接 AI Agent 与 1683+ 个实时数据源的 MCP 网关。

为什么它与 fdic 并存

两者覆盖美国零售银行业互不重叠的两部分，任何一方都无法回答另一方的问题。信用合作社由 NCUSIF 承保，而非 FDIC，因此按定义不会出现在 FDIC 数据中——不是遗漏，也不是不完整，而是数据结构上就不存在。“我的银行有多大”和“我的信用合作社有多大”是两种不同的查询。

banking-regulations 又是另一类内容：该包提供 NCUA 的规则（12 CFR 700–799）。这个包提供的是机构数据。

工具

工具	可回答的问题
ncua_search_credit_unions	奥斯汀（TX）的信用合作社有哪些？——模糊匹配名称、城市或州
ncua_credit_union_profile	Navy Federal 有多大？——资产、会员、贷款、股金、分支机构
ncua_credit_union_financials	查询某个指标的历史数据，或某个季度的所有指标
ncua_rank_credit_unions	俄亥俄州最大的信用合作社有哪些？——按任一镜像指标排名
ncua_compare_credit_unions	并排比较 2 到 5 家
ncua_account_lookup	ACCT_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 万个非零值；完整的 3,376 项每季度会有 133 万个值，存储空间将是 8 倍，而没有人询问过那些长尾数据。

无论如何，都会镜像完整的账户字典，因此对于我们没有存储值的账户，仍然可以解释，而非视为未知——ncua_account_lookup 会为这些账户返回 mirrored_values: false。

季度	20（2021-06 .. 2026-03）
值	384 万
分支机构 / ATM	22,829 / 17,588——仅限当前季度
占用空间	692 MB，其中 440 MB 为索引

为什么这是镜像

NCUA 不提供 API。ncua.gov/api/* 返回 404，而 mapping.ncua.gov（Credit Union Locator）是一个 Angular 应用，无论访问哪个路径都会返回相同的 HTML——它是客户端界面，不是端点。唯一机器可读的形式是季度批量归档，26 个文件压缩后约 7.7 MB。

数据导入：workers/data-pipeline/src/datasets/ncua.ts（定时运行）和 scripts/ingest-ncua.mjs（回填和一次性修复）。架构：supabase/migrations/071_ncua.sql。

数据来源

• https://ncua.gov/analysis/credit-union-corporate-call-report-data/quarterly-data — 季度归档索引。
• https://ncua.gov/files/publications/analysis/call-report-data-YYYY-MM.zip — 单个版本。

下一个维护者否则还得重新发现的内容

• 同一文件有三种 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 服务。目前无法在不包含这些工具的情况下挂载数据包端点；如果额外的架构定义占用的上下文多于路由功能带来的收益，请连接一次完整网关，而不是连接多个数据包端点。

或者连接完整的 Pipeworx 网关，直接列出每个数据包的工具，而不仅是此数据包的工具：

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

两个 URL 都会访问同一个网关和同一批 1683+ 个数据源。唯一的区别是哪些数据包的工具会被直接列出；无论通过哪个 URL，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":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

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

此软件包也可以作为本地 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

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

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

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT