# Bankruptcy Observer

> US business bankruptcy MCP: filings, dockets, documents, case summaries. Free tier + subscription.

- name: com.bankruptcyobserver/mcp
- version: 1.1.0
- connection class: R0 (autonomous)
- trust: 85/100
- quality: 68/100 (needs work)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.bankruptcyobserver%2Fmcp
- tools: https://api.protogrid.dev/v1/servers/com.bankruptcyobserver%2Fmcp/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "bankruptcyobserver": {
      "type": "http",
      "url": "https://mcp.bankruptcyobserver.com/mcp",
      "headers": {
        "Authorization": "Bearer ${BANKRUPTCYOBSERVER_TOKEN}"
      }
    }
  }
}
```

Placeholders to fill: `${BANKRUPTCYOBSERVER_TOKEN}`.

## Trust

- hygiene: 100
- liveness: 99
- freshness: 65
- provenance: 75
- drivers: +repository +dns-namespace +reachable +uptime-97% ~updated-127d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 68/100 (needs work)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-03-26; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 71 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: refresh_docket_tool (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); list_monitored_cases_tool (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_recent_developments_tool (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 3,926 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 50 (weight 15)

- pass `stability.changes`: 5 tool changes in 30 days
- fail `stability.rug_pull`: 5 tools kept their name but changed most of their description in 30 days; review before trusting them

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 18, about 3,926 tokens to load them all
- tool set hash: a2c9baa1896a1df4c7cb91f2d477c175
- tools last changed: 2026-10-08T00:20:08.533Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.bankruptcyobserver/mcp.svg)](https://protogrid.dev/servers/com.bankruptcyobserver/mcp)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-08 `get_cases_by_date_range_tool` changed (description, inputSchema) **meaning changed**
  - before: Cases filed in date range on dateFiled. Omitting both dates defaults to yesterday. Paid.
  - after: US business bankruptcy cases filed in a date range (dateFiled). Individual debtors and adversary proceedings (lawsuits) are omitted unless include_individuals or include_adversary is true. Omitting both dates defaults to yesterday. start_date and end_date are inclusive calendar days (YYYY-MM-DD), including filings later that day. Case numbers are shortCaseNumber. total is the full match count, not the page size. limit is one page (max 500, default 100); pass skip or offset for the next page. has_more is true when more rows remain. Paid.
- 2026-10-08 `get_cases_by_state_tool` changed (description, inputSchema) **meaning changed**
  - before: Cases by debtor state (2-letter). Paid.
  - after: US business bankruptcy cases by debtor state (2-letter). Individual debtors and adversary proceedings (lawsuits) are omitted unless include_individuals or include_adversary is true. start_date and end_date are inclusive calendar days (YYYY-MM-DD). When a date is set, total is the full match count and skip (or offset) pages past limit (max 100). Paid.
- 2026-10-08 `get_cases_by_naics_tool` changed (description, inputSchema) **meaning changed**
  - before: Cases by NAICS (2-4 digits). Paid.
  - after: US business bankruptcy cases by NAICS (2-4 digits). Individual debtors and adversary proceedings (lawsuits) are omitted unless include_individuals or include_adversary is true. start_date and end_date are inclusive calendar days (YYYY-MM-DD). When a date is set, total is the full match count and skip (or offset) pages past limit (max 100). Paid.
- 2026-10-08 `get_cases_by_industry_tool` changed (description, inputSchema) **meaning changed**
  - before: Cases by industry label or key (Hotels, Retail, real-estate, etc.). Paid.
  - after: US business bankruptcy cases by industry label or key (Hotels, Retail, real-estate, etc.). Individual debtors and adversary proceedings (lawsuits) are omitted unless include_individuals or include_adversary is true. start_date and end_date are inclusive calendar days (YYYY-MM-DD). When a date is set, total is the full match count and skip (or offset) pages past limit (max 100). Paid.
- 2026-10-08 `search_bankruptcy_cases_tool` changed (description, inputSchema) **meaning changed**
  - before: Search US business bankruptcy cases by debtor name. FREE (exact/prefix, no *): limited fields, no auth. Use *term for contains (paid). Optional court filter.
  - after: Search US business bankruptcy cases by debtor name. Individual debtors and adversary proceedings (lawsuits) are omitted unless include_individuals or include_adversary is true. Case numbers are shortCaseNumber. FREE (exact/prefix, no *): limited fields, no auth. Use *term for contains (paid). Optional court filter. total is the full match count; pass skip for the next page.

Full history: https://api.protogrid.dev/v1/servers/com.bankruptcyobserver%2Fmcp/changes

## Remotes

- https://mcp.bankruptcyobserver.com/mcp (streamable-http, auth none, reachable true, uptime30d 0.974359)

## Packages

_none_

## Tools (18)

- `add_monitored_case_tool`: Add a bankruptcy case to your BankruptcyObserver.com monitoring list so BKO checks the court hourly and updates the docket every business day. Pass simple_name or a 7-digit case_number (with court_state when needed). Subscribers only; respects your plan monitoring limit.
- `check_subscription_tool`: Check your MCP subscription status and remaining quota. Uses credentials from the request if api_key omitted.
- `get_case_by_case_number_tool`: Look up case(s) by short case number (e.g. 26-10543). FREE for 7-digit format (limited fields, all courts). Paid: full + live_update + court filter.
- `get_case_by_ein_tool`: Look up case by debtor EIN. Paid (full data + optional last filing date). live_update (subscribers) triggers one-time source refresh.
- `get_cases_by_date_range_tool`: US business bankruptcy cases filed in a date range (dateFiled). Individual debtors and adversary proceedings (lawsuits) are omitted unless include_individuals or include_adversary is true. Omitting both dates defaults to yesterday. start_date and end_date are inclusive calendar days (YYYY-MM-DD), including filings later that day. Case numbers are shortCaseNumber. total is the full match count, not the page size. limit is one page (max 500, default 100); pass skip or offset for the next page. has_more is true when more rows remain. Paid.
- `get_cases_by_industry_tool`: US business bankruptcy cases by industry label or key (Hotels, Retail, real-estate, etc.). Individual debtors and adversary proceedings (lawsuits) are omitted unless include_individuals or include_adversary is true. start_date and end_date are inclusive calendar days (YYYY-MM-DD). When a date is set, total is the full match count and skip (or offset) pages past limit (max 100). Paid.
- `get_cases_by_naics_tool`: US business bankruptcy cases by NAICS (2-4 digits). Individual debtors and adversary proceedings (lawsuits) are omitted unless include_individuals or include_adversary is true. start_date and end_date are inclusive calendar days (YYYY-MM-DD). When a date is set, total is the full match count and skip (or offset) pages past limit (max 100). Paid.
- `get_cases_by_state_tool`: US business bankruptcy cases by debtor state (2-letter). Individual debtors and adversary proceedings (lawsuits) are omitted unless include_individuals or include_adversary is true. start_date and end_date are inclusive calendar days (YYYY-MM-DD). When a date is set, total is the full match count and skip (or offset) pages past limit (max 100). Paid.
- `get_case_summary_tool`: Plain-English structured summary of one case: debtor, chapter, court, case number, key dates (filed, plan confirmed, discharged, closed), asset/liability ranges, nature of business, judge, and AI-extracted case profile data when available. Pass simple_name (preferred, see list_monitored_cases_tool) or a 7-digit case_number. Subscribers only.
- `get_docket_entries_tool`: Docket entries for a case, ordered by itemNumber ascending. Each entry includes the full PACER itemText (never sliced) and docket_id — call get_document_tool with that docket_id (no accept_charge) for an inline cost preview, then again with accept_charge: true to download the PDF. Pass simple_name (preferred, see list_monitored_cases_tool) or short_case_number / case_number (e.g. 26-42901; use court_state to disambiguate). Optional docket_id, item_number, or item_from/item_to to fetch specific entries. Single Case plan: monitored cases only. limit max 50 (default 25); pass skip (or offset, or 1-based page) to walk past the first block. A page may contain fewer than limit entries so every caption stays complete for MCP clients. Response includes total, skip, limit, returned, and has_more. Optional live_update refreshes from court sources first. Subscribers only.
- `get_document_cost_tool`: Preview the cost to download a court filing PDF. Identify the entry with docket_id (preferred) or simple_name + item_number (legacy connectors). Does not pull the document and does not charge. Same preview as get_document_tool when accept_charge/download is omitted. Confirm the cost with the user before download. Cost is $0 if already purchased, or if the PDF is already in our library and the plan has flagFreeLibrary. Free-page allowances (if any) come from plan limitDocuments and apply to billable pulls. Returns page_count, chargeable_pages, cost, plan_limit_documents, pages_used_this_period, free_pages_remaining, document_in_library, and already_owned.
- `get_document_tool`: Court filing PDF. Identify the entry with docket_id (preferred) OR simple_name + item_number (legacy cached connectors). Step 1: cost preview — omit accept_charge/download or set false. Step 2: after user confirms, call with accept_charge:true or download:true to purchase and download (signed URL). Returns docket_id in the preview so follow-up calls can use the hash. Pulls from PACER when needed.
- `get_recent_developments_tool`: What happened recently? Docket entries since a date (default: last 7 days) for one monitored case (simple_name) or ALL your monitored cases when simple_name is omitted. Newest first, with item numbers, dates, full itemText (never sliced), and counts. A page may contain fewer than limit entries so every caption stays complete. Subscribers only.
- `list_monitored_cases_tool`: List the cases on your BankruptcyObserver.com monitoring list (case_id, simple_name, name, chapter, court, case number, dateFiled, last docket date). Use get_docket_entries_tool for docket_id values passed to get_document_tool. Requires your MCP token to be linked to your subscriber account. Subscribers only.
- `list_plans_tool`: List available BKO subscription plans (sourced from VwSubscriptions where service = BKO) with current pricing and agent tiers. No auth required.
- `purchase_plan_tool`: Get Stripe checkout URL for a plan. No auth required. Pass plan_id (from list_plans_tool) and optional email.
- `refresh_docket_tool`: Request an immediate docket refresh from court sources for one case (slower; use when you need the latest filings now). Pass simple_name or case_number. Single Case plan: monitored cases only. Full Access: any case. Subscribers only.
- `search_bankruptcy_cases_tool`: Search US business bankruptcy cases by debtor name. Individual debtors and adversary proceedings (lawsuits) are omitted unless include_individuals or include_adversary is true. Case numbers are shortCaseNumber. FREE (exact/prefix, no *): limited fields, no auth. Use *term for contains (paid). Optional court filter. total is the full match count; pass skip for the next page.