MCP server

Courtlistener

io.github.cyanheads/courtlistener-mcp-server

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Search US court opinions, federal dockets, judges, citations, and oral arguments via CourtListener.

Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

14

Token cost

About 7,235 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http courtlistener-mcp-server https://courtlistener.caseyjhand.com/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.courtlistener-mcp-server]
url = "https://courtlistener.caseyjhand.com/mcp"

Gemini CLI

{"mcpServers":{"courtlistener-mcp-server":{"httpUrl":"https://courtlistener.caseyjhand.com/mcp"}}}

Cursor

{"mcpServers":{"courtlistener-mcp-server":{"url":"https://courtlistener.caseyjhand.com/mcp"}}}

VS Code

{"servers":{"courtlistener-mcp-server":{"type":"http","url":"https://courtlistener.caseyjhand.com/mcp"}}}

Antigravity

agy mcp add courtlistener-mcp-server https://courtlistener.caseyjhand.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"courtlistener-mcp-server","server_url":"https://courtlistener.caseyjhand.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"courtlistener-mcp-server","server_url":"https://courtlistener.caseyjhand.com/mcp"}

Tools

• courtlistener_get_citations ~626 tokens
  Retrieve the citation network for an opinion cluster. Supports two directions: "cited_by" (opinions that cite this one — measures precedential influence) and "citing" (opinions this one cites — reveals the authority chain relied on). This is the primary tool for tracing legal precedent chains. Note:
• courtlistener_get_docket ~386 tokens
  Fetch full docket metadata and entry list for a single federal case by docket ID. Returns all available docket entries with document availability status. Documents with is_available=true have a RECAP-stored copy; others require a PACER account. Obtain docket IDs from courtlistener_search_dockets or
• courtlistener_get_financial_disclosure ~402 tokens
  Fetch a judicial financial disclosure by disclosure_id from courtlistener_search_financial_disclosures. Returns metadata, counts and typed line items with coded values decoded to dollar ranges. Select categories or omit for all. Oversized selections return outline then page responses; continue retri
• courtlistener_get_judge ~230 tokens
  Fetch full biographical profile for a single judge: positions on record — judicial appointments across all courts plus non-judicial roles — education, political affiliations, and ABA ratings. The position list is paginated upstream and walked under a page bound; the response reports whether it was t
• courtlistener_get_opinion ~418 tokens
  Fetch text and metadata for an opinion cluster by cluster ID. Returns majority, concurrence and dissent variants with raw HTML and readable plain text, variants_completion for source coverage, and docket_enrichment. Oversized selections return outline then page responses; continue retrieval.next_cur
• courtlistener_get_oral_argument ~361 tokens
  Fetch an oral argument recording by audio_id from courtlistener_search_oral_arguments. Returns case metadata, panel IDs, duration, MP3 URL, docket and available transcript. Oversized text or metadata returns outline then page responses; continue retrieval.next_cursor as cursor with the unchanged ID/
• courtlistener_get_parties ~452 tokens
  Fetch a page of parties and their attorneys of record for a RECAP federal docket by docket ID. Returns each party's name, role (Plaintiff, Defendant, Petitioner, Respondent, etc.), and their attorneys with contact information, scoped to this docket. Costs one party request plus up to five attorney r
• courtlistener_lookup_citation ~608 tokens
  Resolve legal citations (e.g., "410 U.S. 113", "93 S. Ct. 705") to opinion cluster IDs and case metadata. Enables workflows that start from a known citation rather than a search query. CourtListener extracts every citation it finds in the submitted text, so passing a passage returns one entry per ci
• courtlistener_lookup_courts ~982 tokens
  List courts with optional filtering by jurisdiction type, active/inactive status, and scraper coverage. Primarily used to discover court IDs for use in search and filter parameters across all other courtlistener tools. Defaults to the active bench — the courts CourtListener still scrapes; pass statu
• courtlistener_search_dockets ~521 tokens
  Search RECAP federal court dockets. Query terms match case name, docket number, party, and attorney names; filters narrow by party name, court, and filing date. RECAP is a crowd-sourced mirror of PACER (the federal court filing system) — coverage varies by court and date. Returns docket metadata wit
• courtlistener_search_financial_disclosures ~598 tokens
  Search federal judicial financial disclosure filings — the annual reports judges file on investments, gifts, debts, outside positions, and income. Filter by judge (person ID from courtlistener_search_judges) and/or filing year; the year filter is applied to the fetched page only (CourtListener has n
• courtlistener_search_judges ~467 tokens
  Search judge/person records by name, appointing president, court, political affiliation, or demographic. Returns biographical data, current position, and appointment summary. Use courtlistener_get_judge for full appointment history and education records.
• courtlistener_search_opinions ~759 tokens
  Full-text search across 9M+ written US court opinions with field-level filtering. Returns opinion cluster summaries with case metadata, citations, matched text snippets, and the individual opinion variants filed in each case. Supports CourtListener field syntax (caseName:"roe v wade", court_id:scotu
• courtlistener_search_oral_arguments ~425 tokens
  Search appellate oral argument audio recordings — the largest public collection of oral argument audio. Returns recording metadata with two direct MP3 links per result (download_url at the originating court, local_path for CourtListener's durable copy), panel judge IDs, and transcript snippets where

Browse

• GitHub tools
• Web scraping
• PDF tools
• Booking and scheduling
• Legal research

Related MCP servers

• The Stall
  277 pay-per-call MCP tools: YouTube keyword research, stocks, crypto, DeFi, options, macro.
• Court Listener
  CourtListener MCP — Free Law Project's CourtListener API (v4).
• SiteCheck Company Records
  120 pay-per-call agent tools: company registry, government, legal and B2B data tools. x402
• Citiview Agent Market
  186 pay-per-call tools: search, LLMs, UK KYB, FRED, Census, maps, crypto. x402 USDC.
• LiveDataLink
  294 public-data tools across 60 domains; source freshness varies. Free tier.
• Docket Alarm
  Docket Alarm MCP — state + county + federal court dockets (docketalarm.com)
• Federal Civil
  Federal civil litigation — US federal court dockets.
• Transaction Coordinator
  AI transaction coordinator + legal-matters platform for real estate and law firms.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.cyanheads/courtlistener-mcp-server.svg)](https://aptlynx.net/servers/io.github.cyanheads/courtlistener-mcp-server)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents