Brokercheck

@pipeworx/brokercheck

通过 FINRA BrokerCheck 查询股票经纪人、投资顾问代表或经纪公司是否有良好的监管记录。FINRA BrokerCheck 是 FINRA 自行发布的公开职业操守登记系统，供投资者尽职调查使用。

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

工具

• brokercheck_search_individual(query, limit?) — 按姓名搜索个人； 返回 CRD、范围、has_disclosures 标记和当前雇主。
• brokercheck_individual_detail(crd) — 按 CRD 获取完整个人档案；如有披露， 还会返回实际披露事件（类型、日期、处理结果、详情）， 而不只是标记。
• brokercheck_search_firm(query, limit?) — 按名称搜索经纪公司； 返回 CRD、SEC 编号、范围、has_disclosures 标记和分支机构数量。

按名称逐个查询，属刻意设计。 不提供批量枚举工具—— 请参阅下方的使用条款说明。

身份验证

无需密钥。api.brokercheck.finra.org 是 BrokerCheck 自带搜索框调用的同一个公共 API；无需注册或密钥。

使用条款说明（使用此工具包前请阅读）

引自 https://brokercheck.finra.org/terms（BrokerCheck 使用条款） 及其通俗易懂的摘要 https://www.finra.org/investors/learn-to-invest/choosing-investment-professional/about-brokercheck/permitted-uses， 两者均于 2026-09-13 确认为有效：

用户同意遵守 BrokerCheck 使用条款，条款允许将 BrokerCheck 数据用于投资者保护、学术、合规或监管目的。除有限例外情况外，使用条款不允许将 BrokerCheck 用于其他目的……您可以将 BrokerCheck 用于个人和职业用途，以查找投资专业人士；查看当前投资专业人士的背景；协助司法或仲裁程序；遵守证券或金融服务法律、规则和法规；或用于符合促进公平公正的交易原则以及保护投资者和公众利益的类似用途。

如果您的用途属于投资者保护、学术、合规或监管目的，您可以复制和汇编 BrokerCheck 数据，包括使用数据挖掘或类似工具，前提是此类工具不会干扰 BrokerCheck 的正常运行。

再分发要求（在将 BrokerCheck 数据传递给第三方时适用）：注明 BrokerCheck 为来源；提供指向 BrokerCheck 及其使用条款的链接；告知接收方其使用须遵守使用条款；设立更正流程；披露数据汇编时间；保持数据最新。主要禁令：不得更改或修改 BrokerCheck 数据的事实内容；不得将 BrokerCheck 数据用于未经请求的商品或服务营销。

此工具包的合规方式：

• 用途符合许可使用类别。 每个工具都用于回答“查找／审查投资专业人士或公司的背景”这一问题——这正是《使用条款》中所列的个人／专业尽职调查用途——并且每个工具的描述都明确说明了这一点。
• 不缓存、不存储、不进行批量再分发。 每次调用都是实时的、按请求转发至 api.brokercheck.finra.org——不会将数据复制、汇编或重新发布为静态数据集或批量数据集。这更接近实时嵌入式搜索，而非再分发条款所针对的“复制并汇编”／数据挖掘用途；但出于谨慎考虑，每条响应仍包含下方的归属信息块。
• 每条响应都包含归属信息块：source: "FINRA BrokerCheck"、source_profile_url（指向个人／公司 BrokerCheck 资料页的实时链接）、terms_of_use（指向《使用条款》的链接）以及 compiled_at（ISO 时间戳——由于数据是实时转发的，且从不会过时，因此数据是在调用时即时编译的）。
  • terms_of_use_notice：将此数据转发给最终用户的调用方，应告知用户其使用受上述 BrokerCheck《使用条款》约束。
• 不更改事实内容。 字段值按原样传递（为与我们的其他数据包保持一致而重命名／重组，但绝不改写或重新解读）。
• 不用于营销。 此数据包的设计或描述均未鼓励将 BrokerCheck 数据用于未经请求的营销。
• 仅按名称查询——不提供批量枚举工具。 没有“列出所有经纪人”或“枚举 CRD”的工具。两个搜索工具中的 limit 均将单次名称查询结果限制为 50 条，与 BrokerCheck 自身界面返回的结果数量一致；它不能用于爬取注册名录。
• 速率／负载：没有任何查询字符串标志会削弱 FINRA 自身的默认限制；数据包每处理一次工具调用，只会向上游发出一次请求，因此调用方的请求量已经受 Pipeworx 自身的每账户速率限制约束，不会额外形成独立的爬取入口。

结论：可以发布。 此服务形式（实时按名称查询、注明来源、带时间戳、未经更改、非批量）符合上述许可使用条款。但这并不代表此数据包的所有可能用途都已获得许可——无论本 README 如何说明，调用方若试图通过反复按名称查询来枚举整个注册名录，都将超出这些条款的范围；这正是我们不提供批量工具的原因。

数据来源

• https://api.brokercheck.finra.org/search/individual — 个人搜索（ind_* 字段；披露标志为 ind_bc_disclosure_fl）。
• https://api.brokercheck.finra.org/search/individual/{crd} — 个人详情；响应将所有内容包装在 content 下的 JSON 字符串中（需解析），其中包含 basicInformation、currentEmployments、previousEmployments 和 disclosures（每项披露均包含 eventDate、disclosureType、disclosureResolution、disclosureDetail）。
• https://api.brokercheck.finra.org/search/firm — 公司搜索（firm_* 字段；披露标志为 firm_disclosure_fl）。
• 用于引用的公开资料页：https://brokercheck.finra.org/individual/summary/<crd>、 https://brokercheck.finra.org/firm/summary/<crd>。

注意：这是一个与现有 finra 数据包（做空／股票市场数据，受其自身严格的 FINRA 许可条款约束）完全独立的 API，也受独立许可约束——不要将两者合并，也不要假设 finra 的许可条款适用于此处，或反之亦然。

快速开始

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

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

此端点实际提供的内容

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

这是有意为之，并非意外地进行了多路复用。元工具让范围受限的连接也能回答本工具包未涵盖的问题——通过 ask_pipeworx 跨整个目录进行路由——因此你无需再添加第二个 MCP 服务。目前无法在不包含这些元工具的情况下挂载工具包端点；如果额外的架构定义消耗的上下文超过路由带来的价值，请连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出每个工具包的所有工具，而不只是当前工具包的工具：

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

两个 URL 都连接到同一个网关和相同的 1875+ 个数据源。唯一的区别在于，直接列出的是哪个工具包的工具；从任一端点调用 ask_pipeworx 都能访问全部工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/brokercheck_search_individual \
  -H 'Content-Type: application/json' \
  -d '{"query":"John Smith"}'

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

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

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

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

也可以直接运行，以确认其能够启动：

npx -y @pipeworx/mcp-brokercheck

它通过 stdin/stdout 使用 MCP 协议，并仅针对本工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接额外提供的任何共享元工具。源代码相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

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

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

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT