courtlistener-mcp-server
io.github.cyanheads/courtlistener-mcp-servercyanheadsstreamable-httpv0.10.1Scanned
Search US court opinions, federal dockets, judges, citations, and oral arguments via CourtListener.
14 tools: 14 only read.
- Reads private data · 0
- Reads text others write · 7
- Can send data out · 0
- No findings
Tools listed without sign-in. Remote posture
With Anlyon
Decide which of this server's tools your agent can use.
- Anlyon lists the tools and adopts none.
- Each tool you adopt gets approvals and receipts.
- Your agent never holds the key.
A tool your agent calls directly is not routed through Anlyon and is not governed by it. Anlyon Radar only lists and labels, and these labels are the same either way.
What the courtlistener-mcp-server can do
The courtlistener-mcp-server is published by the GitHub account cyanheads. It has 14 tools. Every one of them only reads: going by their definitions, none of them creates, changes, sends or deletes anything.
7 tools bring in text other people can write (courtlistener_search_opinions, courtlistener_get_citations, courtlistener_search_dockets and 4 more).
None of the fixed checks matched anything in its tool definitions. That is not a safety guarantee.
Its remote endpoint lists its tools without sign-in, and its tools changed 3 times since Anlyon Radar first saw them.
Last scanned Nov 21, 2026, version 0.10.1.
Tools
Grouped by what each tool does, most consequential first. Open one for its reasons and full description; descriptions are the publisher's own words.
14 tools
Only reads 14Show 14 read-only tools
courtlistener_get_citationsRetrieve the citation network for an opinion cluster.Reads text others writeNo findings
Why it is in this group
- The name "courtlistener_get_citations" says "get": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: true
- idempotentHint: false
courtlistener_get_docketFetch docket metadata and one entries page by docket ID.No findings
Why it is in this group
- The name "courtlistener_get_docket" says "get": a word for reading.
Description, as the server wrote it 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. Continue retrieval.next_cursor as cursor with the same docket_id, entries page, date bounds, order and document_ids. Top-level next_cursor remains entries pagination. File availability and extracted-text status are independent. Obtain docket IDs from courtlistener_search_dockets or opinion results.
Annotations the server declares
- readOnlyHint: true
- idempotentHint: true
courtlistener_get_financial_disclosureFetch a judicial financial disclosure by disclosure_id from courtlistener_search_financial_disclosures.No findings
Why it is in this group
- The name "courtlistener_get_financial_disclosure" says "get": a word for reading.
Description, as the server wrote it 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 retrieval.next_cursor as cursor with the unchanged ID/categories selection until null. Large individual row fields remain recoverable through text_chunks.
Annotations the server declares
- readOnlyHint: true
- idempotentHint: true
courtlistener_get_judgeFetch full biographical profile for a single judge: positions on record — judicial appointments across all courts plus non-judicial roles — education, political affiliations, and A…No findings
Why it is in this group
- The name "courtlistener_get_judge" says "get": a word for reading.
Description, as the server wrote it 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 truncated. Obtain person IDs from courtlistener_search_judges results.
Annotations the server declares
- readOnlyHint: true
- idempotentHint: true
courtlistener_get_opinionFetch text and metadata for an opinion cluster by cluster ID.No findings
Why it is in this group
- The name "courtlistener_get_opinion" says "get": a word for reading.
Description, as the server wrote it 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 selections return a labeled variant outline then page responses; repeat the same ID, sections and text when continuing retrieval.next_cursor. Oversized docket backfill has independent enrichment_retrieval coordinates; continue its next_cursor as enrichment_cursor and discard prior enrichment slices when source_id changes. Obtain cluster IDs from courtlistener_search_opinions, courtlistener_lookup_citation, or docket results.
Annotations the server declares
- readOnlyHint: true
- idempotentHint: true
courtlistener_get_oral_argumentFetch an oral argument recording by audio_id from courtlistener_search_oral_arguments or courtlistener_get_docket.No findings
Why it is in this group
- The name "courtlistener_get_oral_argument" says "get": a word for reading.
Description, as the server wrote it 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 responses; continue retrieval.next_cursor as cursor with the unchanged ID/sections selection until null. The argument date comes from search or the linked docket.
Annotations the server declares
- readOnlyHint: true
- idempotentHint: true
courtlistener_get_partiesFetch a page of parties and their attorneys of record for a RECAP federal docket by docket ID.No findings
Why it is in this group
- The name "courtlistener_get_parties" says "get": a word for reading.
Description, as the server wrote it 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 roster requests. A later roster page blocked by the local request budget returns fetched detail with capped resolution, unresolved IDs, and the remaining roster cursor. Obtain docket IDs from courtlistener_search_dockets or courtlistener_get_docket.
Annotations the server declares
- readOnlyHint: true
- idempotentHint: true
courtlistener_lookup_citationResolve legal citations (e.g., "410 U.S.No findings
Why it is in this group
- The name "courtlistener_lookup_citation" says "lookup": a word for reading.
Description, as the server wrote it 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 citation, each with its own resolution status — an unresolved or ambiguous citation is reported in the results, not raised as an error. Supports standard US reporter formats. Costs one request against CourtListener's per-citation quota, plus one ordinary request per distinct docket whose court is resolved — max_court_lookups bounds that second half (default 4, set 0 to skip court resolution entirely). CourtListener meters this endpoint by citations submitted rather than by call, so a long passage spends proportionally more of that quota. Requires authentication — uses the CourtListener /citation-lookup/ endpoint.
Annotations the server declares
- readOnlyHint: true
- idempotentHint: true
courtlistener_lookup_courtsList courts with optional filtering by jurisdiction type, active/inactive status, and scraper coverage.Reads text others writeNo findings
Why it is in this group
- The name "courtlistener_lookup_courts" says "lookup": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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 status:'inactive' for historical courts or status:'any' for every court. A bundled snapshot returns matching IDs without paging when the filtered set fits the response budget. Full records come live at a fixed 20 rows per page; pass records:false when you only need IDs. If live records are unavailable, the snapshot still answers.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: true
- idempotentHint: false
courtlistener_search_docketsSearch RECAP federal court dockets by case name, docket number, party, attorney, court, or filing date.Reads text others writeNo findings
Why it is in this group
- The name "courtlistener_search_dockets" says "search": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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 detail. RECAP coverage varies by court and date.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: true
- idempotentHint: false
courtlistener_search_financial_disclosuresSearch federal judicial financial disclosure filings by judge (person ID from courtlistener_search_judges) and filing year.Reads text others writeNo findings
Why it is in this group
- The name "courtlistener_search_financial_disclosures" says "search": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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, and the source PDF link. Use courtlistener_get_financial_disclosure for decoded investment line items.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: true
- idempotentHint: false
courtlistener_search_judgesSearch judge/person records by name, appointing president, court, or political affiliation.Reads text others writeNo findings
Why it is in this group
- The name "courtlistener_search_judges" says "search": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: true
- idempotentHint: false
courtlistener_search_opinionsFull-text search across 9M+ written US court opinions with field-level filtering.Reads text others writeNo findings
Why it is in this group
- The name "courtlistener_search_opinions" says "search": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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:"Alito") and boolean operators (AND, OR, NOT). Use courtlistener_lookup_courts to find court IDs. CourtListener publishes free-tier limits of 5 req/min, 50/hr, 125/day; actual limits vary by token tier.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: true
- idempotentHint: false
courtlistener_search_oral_argumentsSearch appellate oral argument audio recordings — the largest public collection of oral argument audio.Reads text others writeNo findings
Why it is in this group
- The name "courtlistener_search_oral_arguments" says "search": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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 available. Panel judge IDs can be passed to courtlistener_get_judge for biographical context.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: true
- idempotentHint: false
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Exfil surface
Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.
No private-data, untrusted-input, outbound path in this server alone: no tool is tagged private-data or outbound.
- Reads private data0
- Reads files, mail, messages, databases, secrets, calendars or repositories.
- Reads text others write7
- Brings in text someone else can write: web pages, inbound email, messages, issues and comments.
- Can send data out0
- Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.
Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.
Remote posture
What anyone on the internet sees at the remote endpoint: an anonymous initialize and tools/list, and the public OAuth metadata.
Looked at Nov 20, 2026, 19:28 UTC, unchanged since Oct 22, 2026. No credentials were sent and no tool was called. What is looked at.
- Reachable
- yes
- HTTP status of an anonymous initialize
- 200
- tools/list served without credentials
- yes
- Tools that change things, listed without credentials
- 0
- Protocol version
- 2025-06-18
- WWW-Authenticate on 401
- not observed
- resource_metadata in WWW-Authenticate
- not observed
- RFC 9728 protected resource metadata
- not observed
- Authorization servers
- not observed
- Legacy HTTP+SSE transport
- no
- Dynamic client registration
- not observed
- Client ID metadata documents
- not observed
Findings
Matches of fixed checks, with the text they matched.
No check matched anything in these tool definitions. That is not a safety guarantee.
History
Changes to its tool definitions and to its remote endpoint, newest first.
Tools4 changed.~4 changedView diff
- Changed:courtlistener_get_docketOnly readsdescriptioninputSchema
- Changed:courtlistener_get_partiesOnly readsinputSchema
- Changed:courtlistener_lookup_citationOnly readsinputSchema
- Changed:courtlistener_lookup_courtsOnly readsdescriptioninputSchema
Tools10 changed.~10 changedView diff
- Changed:courtlistener_get_citationsOnly readsdescriptioninputSchema
- Changed:courtlistener_get_docketOnly readsinputSchema
- Changed:courtlistener_get_financial_disclosureOnly readsinputSchema
- Changed:courtlistener_get_opinionOnly readsdescriptioninputSchema
- Changed:courtlistener_get_oral_argumentOnly readsdescriptioninputSchema
- Changed:courtlistener_search_docketsOnly readsdescriptioninputSchema
- Changed:courtlistener_search_financial_disclosuresOnly readsdescription
- Changed:courtlistener_search_judgesOnly readsdescriptioninputSchema
- Changed:courtlistener_search_opinionsOnly readsdescriptioninputSchema
- Changed:courtlistener_search_oral_argumentsOnly readsinputSchema
Tools2 changed.~2 changedView diff
- Changed:courtlistener_get_docketOnly readsdescriptioninputSchema
- Changed:courtlistener_get_opinionOnly readsdescriptioninputSchema
Install
Pinned to version 0.10.1. Values in angle brackets are yours to fill in.
claude mcp add --transport http courtlistener https://courtlistener.caseyjhand.com/mcpclaude mcp add --transport http courtlistener https://courtlistener.caseyjhand.com/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__courtlistener__courtlistener_search_opinions",
"mcp__courtlistener__courtlistener_get_opinion",
"mcp__courtlistener__courtlistener_get_citations",
"mcp__courtlistener__courtlistener_lookup_citation",
"mcp__courtlistener__courtlistener_search_dockets",
"mcp__courtlistener__courtlistener_get_docket",
"mcp__courtlistener__courtlistener_get_parties",
"mcp__courtlistener__courtlistener_search_judges",
"mcp__courtlistener__courtlistener_get_judge",
"mcp__courtlistener__courtlistener_lookup_courts",
"mcp__courtlistener__courtlistener_search_oral_arguments",
"mcp__courtlistener__courtlistener_get_oral_argument",
"mcp__courtlistener__courtlistener_search_financial_disclosures",
"mcp__courtlistener__courtlistener_get_financial_disclosure"
],
"ask": [],
"deny": []
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as courtlistener. Review it before you use it.
Capability tags behind 7 rules
- mcp__courtlistener__courtlistener_search_opinions untrusted-input
- mcp__courtlistener__courtlistener_get_citations untrusted-input
- mcp__courtlistener__courtlistener_search_dockets untrusted-input
- mcp__courtlistener__courtlistener_search_judges untrusted-input
- mcp__courtlistener__courtlistener_lookup_courts untrusted-input
- mcp__courtlistener__courtlistener_search_oral_arguments untrusted-input
- mcp__courtlistener__courtlistener_search_financial_disclosures untrusted-input
Pin
Keep the decision: fail CI when the tools change, follow every change, or show a badge.
Pin in CI
Fail a build when the tools you reviewed are not the tools the server serves today.
curl -s "https://radar.anlyon.com/api/v1/servers/io.github.cyanheads/courtlistener-mcp-server/verify?hash=5716ee257b8c99494dd9e7c2da465b7cae0fde3ec5160a0d23792a953b756782" | jq -e '.changed == false'Pinned hash 5716ee257b8c, from Nov 21, 2026, 02:18 UTC.
Watch
Get told when its tools change: a new tool, a new description, a new class.
https://radar.anlyon.com/servers/io.github.cyanheads/courtlistener-mcp-server/changes.xmlAn Atom feed. Works in any feed reader or Slack's RSS app.
Badge
[](https://radar.anlyon.com/servers/io.github.cyanheads/courtlistener-mcp-server)Source: MCP Registry · repository. Synced Nov 21, 2026, 02:17 UTC.
courtlistener-mcp-server: questions and answers
Answered from the scan above, not from the publisher's description.
Is the courtlistener-mcp-server safe?
- No scan can promise that. What its definitions show: 14 tools, all of which only read, and 0 findings from fixed checks. Read-only tools can still pass private data to a model.
Can the courtlistener-mcp-server delete data?
- No tool is classed as destructive: going by their definitions, none of them deletes, cancels or revokes anything.
Can the courtlistener-mcp-server do things that cannot be undone?
- No tool is classed as irreversible: none of them sends, pays, publishes or merges, going by their definitions.
What tools does the courtlistener-mcp-server have?
- 14 tools: 14 read. courtlistener_search_opinions, courtlistener_get_opinion, courtlistener_get_citations, courtlistener_lookup_citation, courtlistener_search_dockets, courtlistener_get_docket, courtlistener_get_parties, courtlistener_search_judges and 6 more.
Does the courtlistener-mcp-server need sign-in or OAuth?
- Its remote endpoint listed its tools to an anonymous client, without sign-in.
Does the courtlistener-mcp-server send data to outside services?
- None of its tools sends, posts or publishes, or takes a recipient, channel or URL.
Has the courtlistener-mcp-server changed its tools?
- Yes, 3 times since Anlyon Radar started tracking it, most recently on Nov 21, 2026. Every change is on this page and in its Atom feed.