Cfpb

CFPB — 消费者金融保护局

CFPB 的消费者投诉数据库。该数据库收录了消费者向 CFPB 提交的所有金融产品投诉（房贷、信用卡、债务催收、银行业务、支付、学生贷款等），并标注公司、产品、问题、回复和结果。自 2011 年以来，投诉数量超过 500 万件。免费、无需身份验证，面向公众开放。

这是 Pipeworx 的一部分——一个将 AI Agent 连接到 1875 多个实时数据源的 MCP 网关。这是一项独立的非官方集成，与上游提供方无关联、未获其认可，也非由其发布。

这对 AI Agent 为何重要

在消费者金融风险评估、品牌声誉分析，或回答“这家公司的状况是否正在恶化？”等问题时，CFPB 投诉是公认的领先指标。投诉激增往往意味着声誉问题正在酝酿，通常早于这些问题反映在财报中。

常见工作流：

• 公司状况。 cfpb_company_complaints({company: "Wells Fargo"}) → 按年份、产品和问题统计投诉量。
• 产品分类。 cfpb_product_breakdown → 按产品类别统计全行业投诉分布。
• 按问题深入分析。 按问题标签筛选（例如，“收取了您意料之外的费用或利息”）。

由 fintech_company_deep_dive 复合工具和 financial_health_check 配方使用。

身份验证

无需身份验证。CFPB 消费者投诉数据库完全公开。

产品分类体系

CFPB 将投诉归入一套稳定的分类体系：

顶级产品	示例
信用卡或预付卡	信用卡、商店卡、预付卡
支票或储蓄账户	银行账户、ATM
抵押贷款	常规贷款、FHA、VA、反向抵押贷款
债务催收	消费债务、发薪日贷款、法律追偿
信用报告	征信机构争议、身份盗用
资金转账 / 虚拟货币	电汇、加密货币、P2P
发薪日贷款 / 汽车产权贷款	短期借贷
学生贷款	联邦贷款、私人贷款

不同产品的投诉量差异很大。一家抵押贷款投诉量高的银行，不能直接与一家“资金转账”投诉量高的金融科技公司相比——背景很重要。

更新频率

每日更新。投诉通常会在提交后约 15 天内显示。消费者反馈（即用户是否将公司的回复标记为“满意”）会在数周内陆续出现。

常见陷阱

• 投诉量 ≠ 不当行为。 一家拥有 100,000 名客户的银行有 100 起投诉，投诉率较低；一家只有 1,000 名客户的小型贷款机构有 50 起投诉，投诉率则高得多。尽可能始终按客户规模或管理资产规模进行标准化。
• 公司名称规范化。 “JPMorgan Chase”、“JPMorgan Chase Bank, N.A.”、“Chase”——在不同语境下都可能指同一家公司。CFPB 会将名称规范化为“company”字段；请尝试搜索多个名称变体进行核实。
• 回复状态的含义。 “经补偿结案”、“未补偿结案”、“经金钱补偿结案”——这些是公司对处理结果的自行分类。请结合每条投诉的叙述了解具体情况。
• 选择偏差。 并非每位不满意的客户都会向 CFPB 投诉。投诉量反映的是消费者对 CFPB 这一申诉渠道的认知，而非纯粹的客户不满程度。与绝对数量相比，时间趋势更有参考价值。
• 行业比较。 在评判公司之前，使用 cfpb_product_breakdown 将其投诉量与行业基准进行比较。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

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

此端点实际提供的内容

https://gateway.pipeworx.io/cfpb/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、discover_tools、search_within、remember/recall 和网关范围内的其他工具。因此，你看到的工具数量会多于此表：目前，单个工具包端点除了列出该工具包自身的工具，还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，是了解当日实际情况的权威信息。

这是有意设计的，并非意外复用。元工具让限定范围的连接也能回答此工具包无法处理的问题——通过可在整个目录中路由的 ask_pipeworx 实现——因此你无需再添加第二个 MCP 服务。目前无法挂载不包含这些元工具的工具包端点；如果额外的 schema 带来的上下文开销超过了路由功能的价值，请连接一次完整网关，而不是连接多个工具包端点。

也可以连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不只是此工具包的工具：

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

两个 URL 都连接到同一个网关和同一组 1875+ 个数据源。唯一的区别是直接列出哪个工具包的工具；无论连接哪一个，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/cfpb_search_complaints \
  -H 'Content-Type: application/json' \
  -d '{"query":"overdraft fees","limit":25}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/cfpb_search_complaints。查找工具包：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

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

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经过网关：

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

也可以直接运行它，确认服务能启动：

npx -y @pipeworx/mcp-cfpb

它通过 stdin/stdout 使用 MCP 通信，并仅针对此工具包的工具响应 initialize/tools/list/tools/call——不包含上文网关连接额外提供的任何共享元工具。相同的源码、相同的工具，但不支持 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗的英语提问，而不必直接调用工具——这在上文的工具包端点和完整网关上都适用：

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

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

更多信息

• 文档与指南
• pipeworx.io

许可证

MIT