plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "courtapi",
  "version": "1.0.0",
  "description": "Search and retrieve US federal court records through CourtAPI and PACER-backed data.",
  "author": {
    "name": "Inforuptcy, LLC",
    "email": "support@courtapi.com",
    "url": "https://www.courtapi.com"
  },
  "homepage": "https://mcp.courtapi.com/docs",
  "keywords": [
    "court records",
    "federal courts",
    "PACER",
    "legal research"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "CourtAPI",
        "shortDescription": "Search federal court records",
        "longDescription": "Search and review US federal court cases, dockets, documents, claims, parties, creditors, and firm activity through CourtAPI. Cached research tools are read-only. Clearly labeled live PACER tools can update records or purchase documents and may incur PACER fees after explicit user approval. CourtAPI provides factual court-record research, not legal advice, and does not cover state courts or government-identifier searches.",
        "developerName": "Inforuptcy, LLC",
        "category": "Business & Operations",
        "capabilities": [
          "Search federal court cases",
          "Review case details and dockets",
          "Retrieve claims, parties, and creditors",
          "Read cached court documents",
          "Refresh records from PACER with approval",
          "Review CourtDrive calendar events with approval"
        ],
        "websiteURL": "https://www.courtapi.com",
        "supportURL": "https://mcp.courtapi.com/docs",
        "privacyPolicyURL": "https://mcp.courtapi.com/privacy",
        "termsOfServiceURL": "https://mcp.courtapi.com/terms",
        "defaultPrompt": [
          "Find federal bankruptcy cases involving Sbarro.",
          "Show recent docket entries for a federal court case.",
          "Summarize a cached federal court document."
        ],
        "brandColor": "#CF4222",
        "composerIcon": "./assets/icon.png",
        "composerIconDark": "./assets/icon-dark.png",
        "logo": "./assets/logo.png",
        "logoDark": "./assets/logo-dark.png"
      },
      "review": {
        "demo_recording_url": "https://drive.google.com/file/d/13qrhp4jaumm3aYjWoGdY2XkvbdJr2sOe/view?usp=sharing",
        "test_cases": {
          "positive": [
            {
              "description": "Find a federal bankruptcy case by party name.",
              "prompt": "Find federal bankruptcy cases involving Sbarro.",
              "tools_triggered": "find_cases",
              "expected_behavior": "Return matching cases with court codes and long-form case numbers for follow-up research, without government identifiers or internal metadata."
            },
            {
              "description": "Review a known case, its docket, claims, and creditors.",
              "prompt": "For case 1:14-bk-10557 in NY Southern Bankruptcy, show the case details, recent docket entries, cached claims register, and creditor list.",
              "tools_triggered": "get_case, get_dockets, get_claims, get_creditors",
              "expected_behavior": "Return the cached case metadata and a concise summary of recent docket entries, then the filed claims and scheduled creditors, clearly distinguishing the two record types without starting a paid refresh."
            },
            {
              "description": "Retrieve and read a cached docket document.",
              "prompt": "Get and summarize the main document attached to docket entry 42.00000 for case 1:14-bk-10557 in NY Southern Bankruptcy, using the cached copy only.",
              "tools_triggered": "get_document, fetch_document_text",
              "expected_behavior": "Return the cached document links and a summary of its redacted OCR text without purchasing an uncached document."
            },
            {
              "description": "Refresh a stale docket after explicit fee approval.",
              "prompt": "Check whether PACER credentials are configured, then refresh the docket for case 1:14-bk-10557 in NY Southern Bankruptcy from PACER, limited to filings since 08/01/2026. I approve the PACER charge; then check the refresh and show the updated docket.",
              "tools_triggered": "check_pacer_credentials, refresh_dockets_from_pacer, get_pacer_refresh_status, get_dockets",
              "expected_behavior": "Report only whether PACER credentials are configured, start one billable refresh, check its task status, and return the updated docket without duplicate refreshes."
            },
            {
              "description": "Review upcoming CourtDrive calendar events after fee approval.",
              "prompt": "Show my CourtDrive calendar hearings and deadlines between 2026-10-14 and 2026-10-31. I approve any calendar event charges.",
              "tools_triggered": "get_calendar_events",
              "expected_behavior": "Confirm before retrieving because newly delivered events are billed, then return the events in that date range with date, title, case, and location, following pagination only as needed and without polling."
            }
          ],
          "negative": [
            {
              "description": "Do not trigger for government-identifier searches.",
              "prompt": "Find every court case associated with my Social Security number."
            },
            {
              "description": "Do not trigger for state court records.",
              "prompt": "Find the docket for my California Superior Court case."
            },
            {
              "description": "Do not trigger for legal strategy or advice.",
              "prompt": "What legal strategy should I use in a contract dispute?"
            }
          ]
        },
        "commerce": false,
        "commerce_description": "CourtAPI does not sell products or process checkout. Some explicitly labeled live PACER retrieval tools may incur PACER access fees billed through the user's CourtAPI account."
      },
      "publication": {
        "release_notes": "Initial CourtAPI plugin release with federal case search, cached court-record research, document retrieval, and explicitly approved live PACER refresh tools."
      },
      "apps": "./.app.json"
    }
  }
}