Legal

Data source: CourtListener / Free Law Project

MCP MCP Protocol

Endpoint https://context.gnist.ai/mcp/court-listener/

nobloat — strip report_feedback tool URL-based auth (for clients without header support)

claude_desktop_config.json

{
  "mcpServers": {
    "gnist-court-listener": {
      "url": "https://context.gnist.ai/mcp/court-listener/",
      "headers": {
        "Gnist-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Shell

curl -X POST "https://context.gnist.ai/mcp/court-listener/" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "search_opinions", "arguments": {"query": "example"}}}'

API REST API

API Root https://context.gnist.ai/rest/court-listener/

6 endpoints available:

GET /rest/court-listener/search_opinions
GET /rest/court-listener/get_opinion
GET /rest/court-listener/search_dockets
GET /rest/court-listener/get_docket
GET /rest/court-listener/get_citations
GET /rest/court-listener/report_feedback

Shell

curl "https://context.gnist.ai/rest/court-listener/search_opinions?query=example" \
  -H "Gnist-API-Key: YOUR_API_KEY"

Python

import httpx

resp = httpx.get(
    "https://context.gnist.ai/rest/court-listener/search_opinions",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    params={
        "query": "example"
},
)
print(resp.json())

OpenAPI Spec · Full API Docs

CLI Command Line

Command gc court-listener

CLI documentation will be available when the GnistAI SDK is published.

Install

pip install gnistai

Available Tools (6)

search_opinions

Search US court opinions by keyword, phrase, or party name.

Parameter	Type	Required	Description
`query`	`string`	required	Search query — keyword, phrase, party name, or legal concept (e.g. "Apple Samsung patent", "qualified immunity", "securities fraud"). Use quotes for exact phrase matching (e.g. '"tortious in...
`court`	`any`	optional	Jurisdiction filter — CourtListener court code. Common values: "scotus" (Supreme Court), "ca9" (9th Circuit), "ca2" (2nd Circuit), "cadc" (DC Circuit), "dcd" (DC District), "nysd" (SDNY...
`date_from`	`any`	optional	Return only opinions filed on or after this date (YYYY-MM-DD).
`date_to`	`any`	optional	Return only opinions filed on or before this date (YYYY-MM-DD).
`limit`	`integer`	optional	Maximum results to return (1–100, default 20). (default: 20)

get_opinion

Retrieve full details for a court opinion cluster by ID.

Parameter	Type	Required	Description
`cluster_id`	`integer`	required	CourtListener opinion cluster ID (from search_opinions results).

search_dockets

Search court dockets by party name to find litigation history.

Parameter	Type	Required	Description
`party_name`	`string`	required	Party name to search for — company, person, or organization (e.g. "Theranos", "Elizabeth Holmes", "Meta Platforms"). Exact phrase matching is applied automatically.
`court`	`any`	optional	Jurisdiction filter — CourtListener court code (e.g. "ca9", "nysd"). If omitted, searches all courts.
`year_from`	`any`	optional	Include only cases filed in this year or later.
`year_to`	`any`	optional	Include only cases filed in this year or earlier.
`limit`	`integer`	optional	Maximum results to return (1–100, default 20). (default: 20)