Ebsa

@pipeworx/ebsa — EBSA 民事罚款执法

自 2000 年以来已结案的美国劳工部雇员福利保障管理局 民事罚款执法行动——针对 ERISA 福利计划发起人提交 Form 5500 时存在缺陷、逾期或未提交的罚款裁定。form5500 已涵盖申报文件本身（即发起人报告的内容）；此处则是 EBSA 针对申报有缺陷、逾期或完全未申报的发起人所采取的执法记录，与 dol-whd（工资与工时、欠薪／加班案件）及 osha（安全违规罚单）不同；这两者都已接入同一个 DOL API 网关。

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

这是民事罚款／申报合规执法记录，而非受托责任违约诉讼案件档案——EBSA 不会发布个人受托责任违约案件结果的批量数据集。这是实际存在、可通过结构化数据进行批量查询的执法数据集。

工具

工具	可解答的问题
ebsa_search	按发起人名称、案件类型、州、计划年度搜索案件
ebsa_sponsor	查询某个指定发起人的完整执法历史和案件类型明细
ebsa_recent	“最近有哪些 EBSA 执法行动结案？”
ebsa_coverage	数据集涵盖范围、发布日期和结案日期范围

身份验证

平台密钥（PLATFORM_DOL_KEY，已在网关上为 dol-whd 和 osha 设置），也可通过 _apiKey 使用自带密钥覆盖。来自 https://dataportal.dol.gov 的免费密钥可访问此网关上的所有 DOL 数据集。一次 实时的同级调用（dol_whd whd_search）已确认平台密钥目前有效 （2026-10-17）——无需新密钥。

实时代理，与 dol-whd 和 osha 使用同一网关

此程序包调用 apiprod.dol.gov/v4——与 dol-whd 完全相同的网关、身份验证方式和 查询语法；dol-whd 已在其 README 和 src/index.ts 的文件头注释中完整说明。这些注意事项在此同样适用，不再重复推导：

• 目录端点（/v4/datasets/10361）接受 X-API-KEY 标头 或不带密钥；行端点（/v4/get/EBSA/ocats/json）会拒绝 标头，必须将密钥作为查询参数传入。
• 无匹配项的查询会返回HTTP 204 和空响应正文，而不是带有 {"data":[]} 的 200 响应。
• 上游按源 IP而非密钥进行限流，且不会发送 Retry-After——此程序包会重试退避两次，然后返回 { found: false, reason: "upstream_rate_limited" }。
• filter_object 的关键字（field、operator、value、and、 or）必须使用小写；数据集名称错误和筛选条件格式错误都会返回通用 HTTP 500。

字段（来自实时数据集，并非猜测）

于 2026-10-17 根据数据集自身的 10 行预览进行实时核验（读取预览无需密钥）：case_type、ein、pn（计划编号）、plan_year、plan_name、plan_admin、plan_admin_state、plan_admin_zip_code、final_close_reason、final_close_date、penalty_amount、load_dt。

penalty_amount 是 DOL 指定的字符串区间，不是精确的金额——实时观测到的值包括 "over $100,000"、 "$50,001 - $100,000"、"$0-$10,000"。此程序包会将其原样传递为 penalty_amount_bucket，绝不会将其解析为数值。

实时观测到的 case_type 值："Deficient Filer"（10 行预览样本中唯一出现的值）；数据集自身的说明也将“逾期申报者”和“未申报者”列为执法重点。case_type 使用 like（子字符串）匹配， 而非精确枚举匹配，因为尚未穷尽观察所有值的具体大小写形式。

不含个人身份信息（PII）

plan_admin 标识计划管理员／赞助方——几乎总是提交强制性公开文件的商业实体（例如实时预览中的 “Shell USA, Inc.”、“Veeva Systems Inc.”、“Spectrum Brands, Inc.”），而非个人。与 LCA/PERM 记录布局不同，OCATS 完全没有联系人或律师姓名／电子邮件／电话列——数据集从未收集这些信息，因此没有任何内容需要删除。

数据来源

• 美国劳工部员工福利保障管理局（Employee Benefits Security Administration）——首席会计师办公室案件跟踪系统（OCATS）。自 2000 年以来已结案且评估过罚款的执法案件，按季度发布。
• https://dataportal.dol.gov — 注册密钥和 API 查询构建器（与 dol-whd 文档所述为同一门户）。

注意事项

• ebsa_coverage 的结案日期样本需要密钥（与 whd_coverage 相同）；目录部分（名称／描述／频率／published_at）则不需要。
• sponsor 查询会对 plan_admin 和 plan_name 都使用 like 匹配，响应会指出匹配的字段（matched_fields）——有时计划自身的名称会包含赞助方名称（例如 “Shell USA, Inc. Health & Wellbeing Plan”），而仅查询管理员字段会遗漏它。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/ebsa/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 都会连接到同一网关和相同的 1878+ 个数据源。唯一的区别是直接列出哪些工具包的工具；无论连接哪一个，ask_pipeworx 都能访问所有工具包。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/ebsa_search \
  -H 'Content-Type: application/json' \
  -d '{"sponsor":"Shell"}'

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

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

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

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

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

npx -y @pipeworx/mcp-ebsa

它通过 stdin/stdout 使用 MCP 通信，并为此工具包中的工具响应 initialize/tools/list/tools/call——不包含上述网关连接额外提供的共享元工具。源代码相同，工具相同，但没有 ask_pipeworx 路由功能。

使用 ask_pipeworx

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

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

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT