`search_dockets`

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

Search US court dockets by keyword. Returns case name, court, filing date, docket number, nature of suit, and assigned judge. Covers PACER and RECAP archives.

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)

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