io.github.cyanheads/courtlistener-mcp-server
v0.8.0Search US court opinions, federal dockets, judges, citations, and oral arguments via CourtListener.
Endpoint health
online- Last checked
- 11/20/2026, 9:18:00 AM
- Latency
- 284 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:io.github.cyanheads%2Fcourtlistener-mcp-server
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"io.github.cyanheads/courtlistener-mcp-server": {
"url": "https://courtlistener.caseyjhand.com/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
14 shown · authentication unknown
Get Citation Network
courtlistener_get_citations
Retrieve the citation network for an opinion cluster. "cited_by" lists opinions that cite this cluster; "citing" lists opinions it cites. Result rows default to Published in both directions; select statuses to expand or narrow the search. The free tier supports shallow traversal and deep multi-hop analysis can exhaust the request budget.
Schema valid · SHA-256 2e07479480a5…
View input schema
{ "type": "object", "properties": { "cluster_id": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991, "description": "Opinion cluster ID to retrieve citations for. Obtain from courtlistener_search_opinions or courtlistener_lookup_citation." }, "direction": { "default": "cited_by", "description": "\"cited_by\" (default): opinions that cite this one — measures precedential influence and downstream adoption. \"citing\": opinions this one cites — reveals the authority chain the court relied on.", "type": "string", "enum": [ "citing", "cited_by" ] }, "court": { "description": "Filter by one court ID or a space-separated list (e.g., \"scotus ca9\"). Applies to both directions. Find IDs with courtlistener_lookup_courts.", "type": "string" }, "filed_after": { "description": "Limit to citations filed after this date (ISO 8601). For \"cited_by\", useful for \"how has this precedent been applied recently?\"", "type": "string" }, "filed_before": { "description": "Latest filing date (YYYY-MM-DD), inclusive.", "type": "string" }, "statuses": { "description": "Publication statuses to include in either direction. Omit for Published only.", "minItems": 1, "type": "array", "items": { "type": "string", "enum": [ "Published", "Unpublished", "Errata", "Separate", "In-chambers", "Relating-to", "Unknown" ] } }, "order_by": { "description": "Sort cited_by results upstream. Omit for relevance. Use citeCount desc for most cited.", "type": "string", "enum": [ "score desc", "dateFiled desc", "dateFiled asc", "citeCount desc" ] }, "page_size": { "default": 20, "description": "Positive requested size (default 20), bounded to 20. cited_by has an upstream minimum of 20; citing slices at most 20 cited IDs by the bounded size before filtering. Full upstream pages are preserved. Final or filtered pages can be smaller or empty; retain next_cursor to continue. page_sizing distinguishes requested, bounded and actual sizes. A normal call costs three requests plus extra variant pages.", "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "cursor": { "description": "Pagination cursor from next_cursor. For citing, a nonnegative safe decimal integer offset; for cited_by, an opaque upstream token.", "type": "string" } }, "required": [ "cluster_id" ], "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }
Connections
streamable-http
https://courtlistener.caseyjhand.com/mcp