CourtAPI — Federal Court Data

CourtAPI MCP 服务

通过 PACER 搜索和获取美国联邦法院的案件、案卷、债权申报和文档，可直接在 Claude 和其他兼容 MCP 的 AI 助手中使用。

功能

此 MCP 服务将 CourtAPI 提供为一组工具，让 AI 助手能够：

• 查找案件：按当事人姓名、案件编号或自由文本关键词搜索所有联邦法院
• 获取案件元数据：标题、章节、法官、立案日期、资产／负债，以及已购买的子资源
• 获取案卷：完整的案卷记录，包含立案历史、关键词搜索和日期筛选
• 下载文档：案卷条目附带的 PDF，并在购买前检查费用
• 获取债权申报：破产债权登记册，包含债权人姓名、金额和债权类型
• 获取当事人：案件中的所有当事人和律师
• 获取债权人：列入计划的债权人（附表 D/E/F），与已提交的债权申报分开
• 搜索 PACER NCL：全国案件定位器，用于跨法院搜索当事人
• 列出法院：约 200 个 PACER 法院及其代码
• 管理 PACER 凭据：存储和验证 PACER 用户名／密码

覆盖范围：所有美国联邦法院，包括破产法院、地区法院和上诉法院。不支持州法院。

---

前置条件

CourtAPI 账户 — 在开发者门户获取凭据（APP_ID + APP_KEY）。可申请免费的 30 天沙盒（每天 150 次 API 调用，每月 500 次）— 请联系 [email protected] 开通。

PACER 账户 — 获取实时数据（案卷更新、文档下载）所必需。可在 pacer.uscourts.gov 免费注册。PACER 按页收取文档费用；CourtAPI 会按成本转收这些费用。

---

安装

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "courtapi": {
      "command": "npx",
      "args": ["-y", "@courtio/courtapi-mcp"],
      "env": {
        "COURTAPI_APP_ID": "your_app_id",
        "COURTAPI_APP_KEY": "your_app_key"
      }
    }
  }
}

重新启动 Claude Desktop。锤子图标中将显示 CourtAPI 工具。

其他 MCP 客户端

此服务默认使用 stdio 传输，与任何 MCP 主机兼容。使用上文相同的 command/args/env 模式。

HTTP 模式（Streamable HTTP 传输）

对于使用 HTTP 而非 stdio 的客户端（例如 OpenAI Responses API 远程工具）：

COURTAPI_APP_ID=your_id COURTAPI_APP_KEY=your_key PORT=3000 \
  npx @courtio/courtapi-mcp --http

从源代码安装

git clone https://gitlab.com/courtio/courtio.git
cd courtio/mcp/courtapi
npm install && npm run build
# then point Claude Desktop at dist/index.js instead of npx

环境变量

变量	必填	说明
COURTAPI_APP_ID	是	你的 CourtAPI 应用 ID
COURTAPI_APP_KEY	是	你的 CourtAPI 应用密钥
COURTAPI_BASE_URL	否	覆盖 API 基础 URL（默认：https://v1.courtapi.com）

---

快速开始

连接后，在 Claude 中尝试以下提示词：

“查找 Sbarro 破产案件，并显示最新的案卷条目”

“搜索 2024 年在特拉华州破产法院立案的第 11 章案件”

“获取纽约南区破产法院案件 1:14-bk-10557 的债权登记册”

“将我的 PACER 凭据设置为用户名 johndoe 和密码 mypassword”

---

工具

find_cases

查找法院代码或完整案件编号未知的案件。传入当事人／公司名称、部分案件编号或自由文本关键词。该工具会自动选择最合适的搜索接口：

• 当事人／标题搜索 — 快速、免费，适用于公司或个人姓名
• 案件编号搜索 — 解析部分或有歧义的编号
• 关键词搜索（search-filings）— 在 CourtAPI 的立案文档库中进行全文搜索；每返回 25 条结果收取 1 次 API 调用

返回其他所有工具所需的 court_code + case_number 组合。

get_case

获取已知案件的所有元数据：标题、章节、法官、关键日期（立案／结案／解除）、资产、负债以及 menu 对象。menu 中每个子资源（案卷、债权、当事方等）各有一个条目，并带有 modified 时间戳——null 表示从未从 PACER 购买该资源。

找到案件后，始终先调用此工具，检查已有的数据。除非 include_live_pacer=true，否则免费。

get_dockets

获取案卷目录——按时间顺序列出所有提交材料，并包含日期、说明和所附文档信息。支持关键词搜索以及按日期／编号范围筛选。

每条案卷记录中都有两个实用字段：

• binder.documents — 预先获取的文档元数据，其中包含每份 PDF 的 is_cached 和 download_cost，因此无需单独调用文档 API 就能检查文档是否可用。
• annotations — 从案卷文本中提取的关键日期（截止日期、听证会等），包含 key_phrase、datetime 和 time_zone。无需解析案卷文本，即可用于构建日历集成。

使用 include_live_pacer=true 从 PACER 购买最新案卷目录时，始终传入 date_filed_from，将购买范围限制为 CourtAPI 尚未收录的新条目。省略该参数会购买完整案卷历史记录——对于正在审理的案件，费用很高。

get_document

获取附在某条案卷记录中的 PDF。会先检查缓存：

• is_cached=true 或 download_cost="0.00" → 免费返回 download_url、preview_url 和 ocr_link
• 未缓存 + purchase=false（默认值）→ 返回费用信息，供你决定是否付费
• 未缓存 + purchase=true → 从 PACER 购买并存储，然后返回 download_url 和 PACER 的 receipt

docket_seq 来自案卷记录（例如 "42.00000"）。part 默认为 1（主文档）；证据和附件的编号更大。

文档购买后会缓存，之后所有 GET 请求均免费。

get_claims

获取破产债权登记册——债权人提交的所有债权申报，包含金额（已申报／已确认／已支付）、债权类型、债权人名称和提交日期。对于 Chapter 11 债权人分析至关重要。

可按 claim_type（有担保、无担保、优先、管理费用等）筛选，并按债权编号、提交日期或修订日期排序。

get_parties

获取案件中的所有当事方（债务人、债权人、原告、被告、受托人），并可选择获取其律师信息，包括律所名称、联系信息和律师资格编号。若该案件尚未购买律师记录，则返回 null（而非错误）——使用 include_attorneys=false 可跳过获取律师信息。

适用于利益冲突检查、送达名单整理，以及确认案件涉及哪些人员。

get_creditors

获取破产申报表 D/E/F 中列出的债权人。这与 get_claims 不同——此处列出的债权人可能并未提交债权申报。两者结合使用，才能完整了解债权人情况。

ncl_search

一次性跨所有联邦法院搜索 PACER 的 National Case Locator。由于直接查询 PACER，在按当事方姓名搜索时比 find_cases 更全面。需要支付 PACER 额度。

支持：姓名搜索、SSN/TIN 查询（需提供姓氏）、案件编号、章节、法院和日期范围筛选。使用上一条响应中的 search_id 翻页。

list_courts

列出约 200 个 PACER 法院及其法院代码和名称。可按类型筛选：bankruptcy、district 或 appellate。

常用代码：nysbke（纽约南区破产法院）、debke（特拉华州破产法院）、ilnbke（伊利诺伊州北区破产法院）、cacdbe（加利福尼亚州中区破产法院）、txnbke（德克萨斯州北区破产法院）。

get_pacer_credentials

管理存储在 CourtAPI 中的 PACER 凭据。任何 include_live_pacer=true 调用前，都必须先提供 PACER 凭据。

action	作用
check	显示存储的 PACER 用户名（不返回密码）
set	存储 pacer_user + pacer_pass（默认会向 PACER 验证）
validate	向 PACER 测试凭据，但不存储
delete	删除存储的凭据

---

了解费用

CourtAPI 有两个独立的费用层：

CourtAPI API 点数 — 根据你的 CourtAPI 方案收费。以下操作免费：案件 GET 查询、当事人/标题搜索、来自缓存的案卷 GET 请求、来自缓存的文档 GET 请求。关键词搜索（search-filings）每 25 条结果计 1 次调用。

PACER 费用 — 美国联邦法院按页收费。仅在以下情况下产生：

• 对案卷、债权、债权人或案件刷新请求设置 include_live_pacer=true
• 对 get_document 设置 purchase=true

download_cost="0.00" 表示文档已缓存，可免费获取。购买前务必先检查。

---

案件编号格式

CourtAPI 要求使用完整格式的 PACER 案件编号。PACER 界面通常显示短格式（例如 14-10557），但 API 始终需要完整格式。

非上诉法院（地区法院、破产法院）：

O:YY-TT-NNNNN

• O — 办公室/分区编号（例如 1、2、3）
• YY — 两位数立案年份
• TT — 案件类型：bk 破产、cv 民事、cr 刑事、ap 对抗程序
• NNNNN — 序列号

示例：1:14-bk-10557（而非 14-10557）

上诉法院：

YY-NNNNN

示例：23-1234

如果 PACER 显示的是短格式，请使用 find_cases 解析。案件编号务必与其 court_code 配对——同一序列号可能存在于多个法院。

---

更新时的 PACER 截图

当 get_dockets 或 get_claims 从 PACER 获取实时数据（include_live_pacer=true）时，响应中会包含 links.screenshot.pdf.href，这是所获取 PACER 页面实际内容的 PDF 截图链接。该链接可用于审计和合规验证。

---

许可证

MIT — © CourtDrive。API 条款请参阅 courtapi.com。