Federal Civil

联邦民事诉讼

美国联邦地区法院的民事诉讼——所有标题不是 United States v. ... 的案件。最大的类别是囚犯民权和人身保护令申请，其次是民权就业、产品责任和合同案件。

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

无需 API 密钥。

这是什么，以及不是什么

案卷元数据：案件是否存在、当事方、法院、案卷编号、立案和终结日期，以及指定法官。它不包含任何提交文件——没有起诉状、动议、辩护状或裁定。这些文件属于 RECAP，是一个需要密钥的独立语料库。

拥有这些数据的 Agent 知道某个案件已经提起，但不知道任何一方提出了什么主张。下文有一个范围有限的例外：无需令牌即可搜索案卷条目描述中的文本，尽管无法搜索文件本身，这正是能够检测移送案件的原因。

已移送案件：removed_from

从州法院移送到联邦法院的案件会对应两条记录，而联邦法院的记录中没有任何内容说明这一点。njd 2:26-cv-05788 是 NS Pharma 将新泽西州高等法院案件 BER-C-000117-26 移送至联邦法院的记录，其 cause 字段显示 09:1 U.S. Arbitration Act——这是援引的联邦法规，并非案件的来源。因此，两个工具都会默认查询原审法院，并将其返回在结果行中：

"removed_from": {
  "state_court": "Superior Court of New Jersey, Chancery Division: Bergen County",
  "state_docket_number": "BER-C-000117-26",
  "notice_filed": "2026-05-20",
  "notice_url": "https://www.courtlistener.com/docket/73371682/1/capricor-therapeutics-inc-v-nippon-shinyaku-co-ltd/",
  "source": "Notice of Removal filed on the federal docket (CourtListener RECAP filing text)"
}

没有该字段不代表没有移送。 没有 removed_from 表示未找到移送通知，而提交文件文本来自 RECAP，它只涵盖有人购买或上传过文件的案卷。每个执行过查询的响应都会在 removal_note 中说明这一点，removal_lookup 则会提供计数——包括找到通知但无法解析出法院和案号的数量；这类通知会被报告，但不会输出不完整的字段。查询遭到限流时会显示为 removal_lookup.error，因此“无法查询”绝不会被当成“未移送”。

这条款通常并不存在，这才是真正的限制。 查询能够可靠地找到移送通知；但通知文本是否写明州法院，取决于将其录入案卷的人。2026-10-11 对四份包含通知的案卷进行实时测量后发现，只有一份采用了可解析的格式（... from Superior Court of New Jersey, Chancery Division: Bergen County, case number BER-C-000117-26），另外三份则没有——其中两份的描述仅为 NOTICE OF REMOVAL by <party> (Filing fee ...)，还有一份完全没有描述。样本量很小，因此应将其理解为“预期会有遗漏”，而不是一个发生率。这三份会计入 removal_lookup.notices_unparsed，而不会根据标题为“PCCP Court Docket”的附件之类的信息推断法院——避免这种看似合理却是臆造的关联，正是此字段存在的目的。

CourtListener 的 /api/rest/v4/dockets/ 接口确实提供结构化的原审法院字段，不受这一限制，但该接口返回 HTTP 401：需要 Free Law Project 账户令牌。此取舍请参阅工具包标题。

设置 check_removal: false 可跳过查询并节省一次上游请求。

工具

工具	返回内容
federal_civil_search	与当事方名称匹配的案卷
federal_civil_recent	最近的案卷，按最新优先排序

注意事项

• 季度快照。 每个响应都包含 snapshot_date。
• date_terminated 的填充率为 78.3%，因此缺少日期表示未记录， 绝不表示仍在审理中。响应会说明是哪种情况。
• nature_of_suit 较为稀疏——在整个语料库中的覆盖率为 14.8%，在地区法院中为 30.5%。 它可以告诉你某家公司是否在联邦法院涉诉，但通常无法告诉你 涉及什么案件。
• 当事方搜索会匹配案件标题中的子字符串，因此使用有辨识度的当事方 名称比使用完整案件标题更有效。
• 移送查询每次调用最多检查 20 个案卷，分 10 个一批，因为上游立案搜索受到速率限制：无令牌的调用者每分钟最多请求 5 次，每天约 125 次。当响应返回的行数超过此上限时，removal_lookup.not_checked 会说明有多少条记录尚未检查——应将这些记录视为未知，而不是视为未移送。

数据归属

数据来自 CourtListener / Free Law Project，以 Public Domain Mark 发布。Free Law Project 负责资助并维护该语料库。如果此工具包对你有用，可通过 https://free.law/donate/ 捐助。

快速入门

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/federal-civil/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 都指向同一个网关和相同的 1879+ 个数据源。唯一的区别在于直接列出的是哪个工具包的工具；从任一端点都可以通过 ask_pipeworx 访问所有工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/federal_civil_search \
  -H 'Content-Type: application/json' \
  -d '{"party":"Monsanto","limit":5}'

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

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

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

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

或者直接运行，确认它能正常启动：

npx -y @pipeworx/mcp-federal-civil

它通过 stdin/stdout 使用 MCP 通信，并响应 initialize/tools/list/tools/call， 仅提供此工具包自身的工具——不包含上述网关连接所添加的共享元工具。数据源和工具相同，但不提供 ask_pipeworx 路由。

使用 ask_pipeworx

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

ask_pipeworx({ question: "your question about Federal Civil data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT