Bankruptcy Observer MCP API Public Documentation

破产观察员-API&MCP

公共文件和登记元数据 破产观察员API 和 MCP服务器。此存储库不包含应用程序源代码。

这是什么

• 破产REST API --程序化访问美国企业破产数据（搜索、按EIN分类、备审项目、按NAICS/州分类的案件等）。
• 破产MCP服务器 --通过相同的数据和查询 模型上下文协议 用于AI助手和LLM工作流程。

数据涵盖 美国企业破产 （联邦法院）。不包括仅面向消费者的申请和非美国司法管辖区。

______________________________________________________________________

免费查找（无令牌，无API密钥，无支付）

人工智能助手和用户可以通过以下方式查找破产案件 没有帐户，没有API密钥，也没有API令牌:

• 称这些工具为 没有API令牌只需要案件编号或名称； 不需要法院。如果多个案件匹配（例如，多个法院的案件编号相同），服务器将返回 全部 匹配案例。每个结果包括有限的案例信息；完整的案件细节可通过付费计划获得。
• 所有其他查询（通配符搜索、EIN、行业、州、日期范围、案卷等）都需要使用API令牌或OAuth Bearer访问令牌进行订阅和身份验证。

文件： https://mcp.bankruptcyobserver.com/docs 或 https://api.bankruptcyobserver.com/docs （GET，无身份验证）。MCP根 GET https://mcp.bankruptcyobserver.com/ 也返回a free_lookups 提示。

______________________________________________________________________

注册和访问

你可以 通过MCP服务器注册订阅：使用 list_plans_tool 那么，看看计划 purchase_plan_tool 和 plan_id （例如。 professional, business, enterprise)获取Stripe Checkout链接。付款后，您将收到API代币；受限查询可以使用该令牌或MCP OAuth流中的OAuth承载访问令牌进行身份验证。无需访问网站进行订阅。

有关访问、计费或数据覆盖范围的问题，请使用 仅 联系表格在https://www.bankruptcyobserver.com/contact.不要发布或使用直接电子邮件地址进行联系。

付费计划（通过MCP工具Stripe）

• 专业的 --每月1500美元，最高可达 500 计费工具调用/月。
• 商业 --每月3500美元，最高可达 10,000 计费工具调用/月。
• 企业 --每月5000美元，最高可达 150,000 每月计费工具调用（针对多个客户/团队）。

收费工具调用对应于通过MCP（例如，搜索、逐个EIN、案卷项目、NAICS/状态过滤器）或其REST API等同物调用的数据工具。

使用以下方式之一发送的API令牌或OAuth访问令牌进行身份验证：

• Authorization: Bearer
• X-API-Key:
• Api-Key:

______________________________________________________________________

通过OpenAI连接

使用OpenAI 响应API 直接调用此MCP服务器。

免费等级（无代币）：

from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="gpt-4.1",
    tools=[{
        "type": "mcp",
        "server_label": "bankruptcy_observer",
        "server_url": "https://mcp.bankruptcyobserver.com/mcp",
        "require_approval": "never",
    }],
    input="Search for bankruptcy cases for Acme Corp",
)
print(response.output_text)

付费层（带令牌）：

response = client.responses.create(
    model="gpt-4.1",
    tools=[{
        "type": "mcp",
        "server_label": "bankruptcy_observer",
        "server_url": "https://mcp.bankruptcyobserver.com/mcp",
        "headers": {"Authorization": "Bearer YOUR_TOKEN"},
        "require_approval": "never",
    }],
    input="Get docket entries for case 24-10543",
)

注： 不设置 Content-Type 或 Accept 手动设置标头——OpenAI客户端为MCP协议正确设置这些标头。覆盖它们将导致服务器返回HTML错误页面，而不是JSON响应。

OAuth选项： ChatGPT等连接器还可以通过MCP OAuth进行身份验证，并在登录后自动发送承载访问令牌。API令牌头仍然受支持。

______________________________________________________________________

在ChatGPT（OAuth）中连接

要将ChatGPT中的此MCP服务器与OAuth连接，请创建 新应用程序/连接器 并在下面准确输入OAuth端点。

如果 注册URL 如果省略，动态客户端注册将失败，ChatGPT将在没有可用工具授权的情况下连接。

OAuth端点

• 身份验证URL: https://mcp.bankruptcyobserver.com/authorize
• 令牌URL: https://mcp.bankruptcyobserver.com/token
• 注册URL: https://mcp.bankruptcyobserver.com/register
• 授权服务器基础： https://mcp.bankruptcyobserver.com/
• 资源： https://mcp.bankruptcyobserver.com/mcp

连接后，ChatGPT应在浏览器中完成OAuth，然后使用OAuth承载令牌调用工具。使用标头身份验证的客户端仍然支持旧版的API到ken标头。

______________________________________________________________________

端点

这 /mcp 路径是MCP协议端点（仅POST）。对于人类可读的文档，请使用 文档 上面的URL（GET，无身份验证）。

______________________________________________________________________

可用的查询和响应

在REST API和MCP服务器上都可以使用相同的查询。每个查询返回JSON；除非另有说明，否则案例级响应包括以下标准字段。

查询列表

分页： 列表响应支持 limit 和 skip 在适用的情况下；回应包括 total 或在有用的情况下类似。

日期范围： 对于NAICS和州查询，可选 start_date 和 end_date 过滤器打开 dateFiled。搜索不支持日期筛选器。

标准字段（案例级别）

对于任何返回案例行的查询，都会返回：

可选的 （相关时包括在内）： courtState, chapter, NAICS, industry, dateClosed, dateDismissed, isOpen / isClosed / isDismissed, assetAmount, liabAmount.

查询 ： einInDatabase

对于 EIN案例 响应总是包括：

• einInDatabase — "Yes" 如果我们至少有一个与此EIN有关的案例（以及案例有效载荷）； "No" 如果我们没有此EIN的案例（案例有效载荷为空或省略）。

Docket响应形状

对于 卷宗项目 你得到：

• 案件标识符（例如shortCaseNumber、court）。
• dateDocket已更新 --本案的卷宗上次在我们的系统中更新是什么时候。
• 条目 --对象数组至少包含 itemNumber, itemText, itemDate （以及可选的pageCount、pacerDocId）。

______________________________________________________________________

API与MCP映射

两者后端相同；响应形状相同。

______________________________________________________________________

完整文档（规范）

完整规范（与上述内容相同，加上任何更新）也在以下位置提供，无需身份验证：

• API文件： https://api.bankruptcyobserver.com/docs
• MCP文件： https://mcp.bankruptcyobserver.com/docs

两个URL返回相同的Markdown。将它们用于最新版本或AI/bot发现。

______________________________________________________________________

注册表

此回购包括 server.json 为了 MCP官方登记处.描述了远程MCP服务器以及如何连接（URL+neneneba API令牌头）。通过注册表CLI发布到注册表时使用它；注册表指向此GitHub仓库仅用于元数据。

______________________________________________________________________

许可证

此存储库中的文档和元数据用于发现和集成。破产观察员产品、API和MCP服务根据单独条款提供；请访问产品网站。