Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

Courtlistener MCP Server

von cyanheadsVersion 0.10.0i★ 4iComputer oder CloudOffizielle Website ↗
Name in der Registryio.github.cyanheads/courtlistener-mcp-server

So installierst du es

What it does

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

  • Connects Computer oder Cloud
  • Account or key Cloud: No key needed · Local: Needs COURTLISTENER_API_TOKEN
  • Category Recht & Behördendaten

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit8/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch8/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert28/100

Qualität: 5/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte Courtlistener MCP Server. Folge https://mcp.popnx.com/i/cyanheads-courtlistener-mcp-server.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

5/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (courtlistener.caseyjhand.com) · ✓ Befehle geprüft am 14. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 2 Min.

Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameCourtlistener MCP Server
    Remote MCP server URL · Adressehttps://courtlistener.caseyjhand.com/mcp

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  3. Im Chat einschalten

    +ConnectorsCourtlistener MCP Server

  4. Ausprobieren

    Nutze Courtlistener MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Courtlistener MCP Server nutzt, oder ein Werkzeug von Courtlistener MCP Server in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit ChatGPT je nach Tarif

Volles MCP: ChatGPT Business, Enterprise oder Edu im Web · Pro: verbindet mit Lese-/Abrufrechten, Werkzeuge, die Daten ändern, gehen evtl. nicht · Plus: in der Doku nicht bestätigt; siehst du auf der Plugins-Seite eine Option für eigene MCP-Server, kannst du es versuchen · nur Web

  1. In ChatGPT im Web die Seite zum Hinzufügen von MCP öffnen

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Name und Adresse eintragen

    Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken

    Name · NameCourtlistener MCP Server
    Connection · Adressehttps://courtlistener.caseyjhand.com/mcp
  3. Courtlistener MCP Server im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen Courtlistener MCP Server aus deinen Plugins wählen

  4. Ausprobieren

    Nutze Courtlistener MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es Courtlistener MCP Server nutzt, oder ein Werkzeug von Courtlistener MCP Server in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von OpenAI abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Claude Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  2. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user courtlistener https://courtlistener.caseyjhand.com/mcp
  3. /mcp in Claude Code eingeben

    Courtlistener MCP Server sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze Courtlistener MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Courtlistener MCP Server nutzt, oder ein Werkzeug von Courtlistener MCP Server in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in Cursor im Agent-Modus öffnen

  3. Ausprobieren

    Nutze Courtlistener MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Courtlistener MCP Server nutzt, oder ein Werkzeug von Courtlistener MCP Server in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in VS Code im Agent-Modus öffnen

  3. Ausprobieren

    Nutze Courtlistener MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Courtlistener MCP Server nutzt, oder ein Werkzeug von Courtlistener MCP Server in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://courtlistener.caseyjhand.com/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Courtlistener MCP Server nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

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

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user courtlistener --env COURTLISTENER_API_TOKEN=your-value -- npx -y @cyanheads/courtlistener-mcp-server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "courtlistener": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/courtlistener-mcp-server"
      ],
      "env": {
        "COURTLISTENER_API_TOKEN": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "courtlistener": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/courtlistener-mcp-server"
      ],
      "env": {
        "COURTLISTENER_API_TOKEN": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "courtlistener": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/courtlistener-mcp-server"
      ],
      "env": {
        "COURTLISTENER_API_TOKEN": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

  • COURTLISTENER_API_TOKEN geheim erforderlich env
    CourtListener-API-Token aus Ihren Kontoeinstellungen. Für den API-Zugriff erforderlich.
    Englisches Original anzeigenCourtListener API token from your account settings. Required for API access.
  • MCP_LOG_LEVEL env
    Legt die minimale Protokollstufe für die Ausgabe fest (z. B. 'debug', 'info', 'warn').
    Englisches Original anzeigenSets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
187/Wo.
Lizenzi
Apache-2.0
Verbindung
Computer oder Cloud
Transport
stdio, streamable-http
Neueste Versioni
0.10.0
In der Registry veröffentlichti
13. Nov. 2026
Code zuletzt geänderti
13. Nov. 2026
Zuletzt geprüft
18. Nov. 2026
Entwickler
cyanheads
Pakete
npm: @cyanheads/courtlistener-mcp-server
npm: @cyanheads/courtlistener-mcp-server
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 18. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.

  • courtlistener_search_opinions

    Full-text search across 9M+ written US court opinions with field-level filtering. Returns opinion cluster summaries with case metadata, citations, text previews, and individual opinion variants. Supports CourtListener field syntax (caseName:"roe v wade", court_id:scotus, judge:"A

  • courtlistener_get_opinion

    Fetch text and metadata for an opinion cluster by cluster ID. Returns opinion variants with raw HTML and readable plain text by default, variants_completion for source coverage, and docket_enrichment. Choose text: plain or html for a single text representation. Oversized selectio

  • 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

  • courtlistener_lookup_citation

    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 retu

  • courtlistener_search_dockets

    Search RECAP federal court dockets by case name, docket number, party, attorney, court, or filing date. Returns docket metadata, indexed roster counts, and up to three sample filings per docket. Select roster names with include or use courtlistener_get_parties for docket-scoped d

  • courtlistener_get_docket

    Fetch docket metadata and one entries page by docket ID. Omit document_ids for the docket listing, or select RECAP document IDs embedded on entries_page to retrieve their extracted text without further upstream requests. Selected text uses bounded full/outline/page responses; con

  • courtlistener_get_parties

    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 u

  • courtlistener_search_judges

    Search judge/person records by name, appointing president, court, or political affiliation. Returns biographical data, current position, and appointment summary. Use courtlistener_get_judge for full appointment history and education records.

  • courtlistener_get_judge

    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 repo

  • courtlistener_lookup_courts

    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

  • courtlistener_search_oral_arguments

    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 trans

  • courtlistener_get_oral_argument

    Fetch an oral argument recording by audio_id from courtlistener_search_oral_arguments or courtlistener_get_docket. Returns case metadata, panel IDs, duration, court and CourtListener MP3 URLs, docket and available transcript. Oversized text or metadata returns outline then page r

  • courtlistener_search_financial_disclosures

    Search federal judicial financial disclosure filings by judge (person ID from courtlistener_search_judges) and filing year. The year filter applies to the fetched page only; follow the cursor to find matches on later pages. Returns filing metadata, category counts, itemized gifts

  • courtlistener_get_financial_disclosure

    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 respo

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto cyanheads bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 6 Tagen

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt Apache-2.0

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 233 ms (HTTP 200)

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Keine Anmeldung nötig

  • ✓ Bestanden

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Wir haben 14 Tool-Beschreibungen gelesen und keine versteckten Anweisungen an die KI gefunden

Die Cloud-Adresse hat bei 4 der letzten 4 Prüfungen geantwortet · zuletzt 233 ms · geprüft 18. Nov. 2026

Veröffentlichte Schwachstellen (OSV.dev)

Keine Einträge auf OSV.dev für @cyanheads/courtlistener-mcp-server@0.10.0

Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 15. Nov. 2026

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/cyanheads-courtlistener-mcp-server.svg)](https://mcp.popnx.com/en/servers/cyanheads-courtlistener-mcp-server)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Recht & Behördendateni

  • Mehr Sterne als 95 % der anderen 1951 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 87 % der anderen 1951 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 1951 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Courtlistener MCP Server sicher?

Er hat 5 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: COURTLISTENER_API_TOKEN

Läuft er auf meinem Computer oder in der Cloud?

Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 6 Tagen geändert, und die neueste Version (0.10.0) kam vor 6 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Global law

The law of nearly every country on earth, any date: read it, see what changed it, check citations.

von lexifinaWeit verbreitet★ 2096Aktualisiert vor 9 Tagen

Läuft in der Cloud✓ lexifina.com

LibreJustice

Search French-language and European case law and French legal texts (codes, statutes, treaties).

von librejusticeAm Anfang★ 36Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · librejustice.fr

InfraNode

Keyless open data for 84 German cities: 12 lean read-only MCP tools covering 67 data types.

von street1983nkAm Anfang★ 18Aktualisiert vor 5 Monaten

Läuft in der Cloud✓ vom Dienst · infranode.dev

Fedlex Connector

Search Swiss federal legislation: laws, articles, amendments via the Fedlex SPARQL endpoint.

von JayTheSkierAm Anfang★ 8Aktualisiert vor 7 Monaten

Läuft in der Cloud✓ vom Dienst · fedlex-connector.ch
Im Vergleich mit ähnlichen
Dieser
Courtlistener MCP Server
Global lawOpen Legal Data (Germany)LibreJusticeInfraNodeFedlex Connector
Läuft woIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselJaNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinNein
Basisprüfungen5/54/44/44/44/44/4
LizenzApache-2.0NOASSERTIONMITApache-2.0Apache-2.0MIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

@cyanheads/courtlistener-mcp-server Search and retrieve US court opinions, federal dockets, judge records, citation networks, and oral arguments from CourtListener's 9M+ opinion corpus via MCP. STDIO or Streamable HTTP. 14 Tools • 2 Resources • 1 Prompt

Public Hosted Server: https://courtlistener.caseyjhand.com/mcp


Overview

US case law and federal court records from CourtListener's 9M+ opinion corpus and its RECAP mirror of PACER. Search opinions and dockets, trace citation networks, resolve citations, look up judges and courts, and read oral argument transcripts and judicial financial disclosures.

Tools
ToolDescription
courtlistener_search_opinionsFull-text search across 9M+ court opinions with field syntax, court, date, and status filters
courtlistener_get_opinionFetch an opinion cluster's metadata and variant text (majority, concurrence, dissent), with source-completion status
courtlistener_get_citationsTrace a cluster's citation network: opinions it cites (citing) or that cite it (cited_by)
courtlistener_lookup_citationResolve every citation in a text (e.g. "410 U.S. 113") to cluster IDs and case metadata
courtlistener_search_docketsSearch RECAP federal dockets by case name, party, attorney, court, and filing date
courtlistener_get_docketFetch a federal docket's paged entries or selected filings' extracted text
courtlistener_get_partiesFetch the parties and attorneys of record on a RECAP docket
courtlistener_search_judgesSearch judges by name, appointing president, court, and political affiliation
courtlistener_get_judgeFetch a judge's positions, education, political affiliations, and ABA ratings
courtlistener_lookup_courtsList courts by jurisdiction type, active/inactive status, and scraper coverage
courtlistener_search_oral_argumentsSearch appellate oral argument recordings by case name, transcript text, court, and argument date
courtlistener_get_oral_argumentFetch one oral argument's panel, duration, MP3 link, and speech-to-text transcript
courtlistener_search_financial_disclosuresSearch judicial financial disclosure filings by judge and year
courtlistener_get_financial_disclosureFetch one disclosure's line items with coded values decoded to dollar ranges
Resources
ResourceDescription
courtlistener://reference/courtsJurisdiction codes, common court IDs, search type codes, rate limits, and the maintenance window
skill://courtlistener-guide/SKILL.mdResearch guide for identifier chains, text completion, citation treatment, and coverage limits

The jurisdiction codes are also listed on the jurisdiction parameter of courtlistener_lookup_courts, for clients that don't surface resources.

Prompts
PromptDescription
courtlistener_research_topicGenerate a structured legal research plan for a topic or question

Capability reference

Result-page sizes accept positive integers and bound outgoing requests: 20 for searches/citations, 10 for parties, and 50 for docket entries. Both response surfaces carry page_sizing (requested, bounded, actual, upstream). Upstream search/disclosure pages have a 20-row minimum, parties/entries use fixed 20-row pages, and citing slices cited IDs before searching. Returned pages are preserved; empty/final pages and page-local filters can produce fewer rows. Continue with the native cursor rather than increasing the requested size.

Opinion, docket, judge, and oral-argument searches accept q: "*" for filter-only queries. Their court filter, and the citation tool's, accepts space- or comma-separated IDs and resolves known IDs case-insensitively to their canonical spelling. Unfamiliar IDs retain their casing and still reach CourtListener; use courtlistener_lookup_courts to check them.

courtlistener_search_opinions tool
  • q is required and takes CourtListener field syntax (caseName:"roe v wade", court_id:scotus, judge:"Alito") and AND / OR / NOT; filter by court, filed_after / filed_before, and status, and sort with order_by (score desc default, dateFiled desc, dateFiled asc, citeCount desc); 20 results per page, continued with next_cursor
  • Each result carries cluster_id (for courtlistener_get_opinion and courtlistener_get_citations), docket_id, cite_count, a snippet, and opinions[] variants with opinion ID, type, author_id, and local_path; totalCount and effectiveQuery report the match
  • Omit status for CourtListener's Published default, or select one publication status, including In-chambers and Relating-to.
  • snippet uses the first variant with an upstream excerpt. Highlighting requests query context; filter-only queries can still return opening text or no excerpt. Highlight markup is removed without losing its words.
  • Variant cites arrays are omitted by default. Use include: ["cites"] for complete cited-opinion IDs at the existing opinions[].cites path.

courtlistener_get_opinion tool
  • cluster_id is required; after an outline response, sections: ["opinion_ ", ...] pulls specific variants, and a name the cluster doesn't have fails as unknown_section
  • Cluster metadata (case name, court_id, citations, cite_count, precedential_status, syllabus, posture, docket_id) plus each variant's html_text, plain_text, cites[], download_url, and type_label, the same label courtlistener_search_opinions reports
  • Outline entries identify each variant's type_label, author_id, and per_curiam. Select text: "plain" or "html" to retrieve only that text representation; omission or "both" keeps both. Keep the text mode unchanged on continuations.
  • Small responses use kind: "full". Oversized variants or metadata return a bounded outline, then typed page responses through retrieval.next_cursor; repeat the original ID and selection with cursor until null.
  • Supplied plain_text is preserved; markup-only variants gain readable text with paragraphs, tables, lists, footnotes, and decoded entities. html_text retains raw source and renders as fenced text. Search/citation snippets use the same readable normalization.
  • variants_completion reports whether the bounded source walk finished and its remaining upstream variant cursor. docket_enrichment distinguishes not_linked, resolved, source_fields_absent, and lookup_failed with a sanitized failure category; cancellation propagates.
  • Primary continuation remains stable when optional docket enrichment changes. Oversized enrichment has its own enrichment_retrieval.next_cursor, passed as enrichment_cursor with the same cluster and selection. Keep enrichment chunks only while source_id is unchanged; a changed source restarts that stream. A metadata-only partial response can have a null primary cursor while enrichment continues. Legacy v1 cursors retain their original enrichment-sensitive behavior.

courtlistener_get_citations tool
  • cluster_id is required; direction is cited_by (default, opinions that cite this one) or citing (opinions it cites); optional court, filed_after, filed_before, and statuses filters; up to 20 results per page, continued with cursor. Omit statuses for CourtListener's Published default or select one or more statuses. order_by applies only to cited_by.
  • Rows carry cluster_id, court_id, date_filed, cite_count, and snippet; for citing, totals count the unfiltered cited-opinion list, and a filtered page can come back empty while next_cursor is still set. source_variants_completion and total_is_partial qualify observed_total; incomplete variants make this a lower bound and omit the exact totalCount trailer.
  • Citation snippets remain opening excerpts. Inbound totals count matching clusters after the selected filters; repeat filters and sorting on continuation.
  • For citing, cursor is a nonnegative safe decimal integer offset (01, +1, 1.0, and 1. all mean 1); malformed offsets fail as invalid_cursor before any request. An offset at or past the end returns an empty page with the source name and unfiltered distinct-opinion total, without searching. cited_by cursors stay opaque.

courtlistener_lookup_citation tool
  • citation takes one citation or a passage of up to 64,000 characters, and every citation in it resolves; max_court_lookups (default 4, max 20, 0 to skip) caps the docket requests spent on court names
  • One matches[] entry per citation, with status (200 one case, 300 several candidates, 400 unrecognized reporter, 404 no match, 429 past the per-request citation cap) and status_label; each of its clusters[] carries cluster_id, docket_id, court_id, and court_resolution (resolved, no_docket, lookup_failed, over_budget, only the last worth retrying with a larger budget)
  • Unresolved citations come back as entries, not errors; only text with no parseable citation fails, as not_found. CourtListener meters this endpoint per citation submitted, separately from the per-request limits

courtlistener_search_dockets tool
  • q is required and matches case name, docket number, party, and attorney names; party_name (ANDed with q), court, and filed_after / filed_before narrow it; 20 results per page, continued with next_cursor
  • Each docket carries docket_id, party_count, attorney_count, firm_count, suit_nature, assigned_to / referred_to, and up

Nur der Anfang wird gezeigt; den Rest findest du im Repo