`search_dockets`

Pack: court-listener · Endpoint: https://gateway.pipeworx.io/court-listener/mcp

Search US court dockets by keyword. Covers PACER and RECAP archives. Each result carries docket_id, case name, court, filing and termination dates, docket number, nature of suit, the cause of action, the assigned judge, and the PACER case id.

Parameters

Name	Type	Required	Description
`query`	string	yes	Search keywords (e.g., “antitrust merger”)
`court`	string	no	Court filter (e.g., “nysd” for Southern District of New York)
`limit`	number	no	How many dockets to return, 1–100 (default 20). CourtListener pages at 20, so higher values fetch additional pages.

Example call

Arguments

{
  "query": "antitrust merger"
}

curl

curl -X POST https://gateway.pipeworx.io/court-listener/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_dockets","arguments":{"query":"antitrust merger"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('search_dockets', {
  "query": "antitrust merger"
});

More examples

{
  "query": "class action consumer fraud",
  "court": "nysd"
}

Response shape

Always returns: query, total, returned, dockets

Field	Type	Description
`query`	string	The search query used
`total`	number	Total number of matching dockets
`returned`	number	Number of dockets in this response
`dockets`	array	List of docket search results

Full JSON Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The search query used"
    },
    "total": {
      "type": "number",
      "description": "Total number of matching dockets"
    },
    "returned": {
      "type": "number",
      "description": "Number of dockets in this response"
    },
    "dockets": {
      "type": "array",
      "description": "List of docket search results",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "number",
              "null"
            ],
            "description": "Docket ID"
          },
          "caseName": {
            "type": [
              "string",
              "null"
            ],
            "description": "Case name"
          },
          "court": {
            "type": [
              "string",
              "null"
            ],
            "description": "Court identifier"
          },
          "dateFiled": {
            "type": [
              "string",
              "null"
            ],
            "description": "Date docket was filed"
          },
          "docketNumber": {
            "type": [
              "string",
              "null"
            ],
            "description": "Docket number"
          },
          "suitNature": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nature of suit"
          },
          "snippet": {
            "type": [
              "string",
              "null"
            ],
            "description": "Text snippet from docket"
          },
          "absolute_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "URL to docket"
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Docket status"
          }
        }
      }
    }
  },
  "required": [
    "query",
    "total",
    "returned",
    "dockets"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "court-listener": {
      "url": "https://gateway.pipeworx.io/court-listener/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

search_dockets