{"data":{"name":"io.github.cyanheads/courtlistener-mcp-server","title":null,"description":"Search US court opinions, federal dockets, judges, citations, and oral arguments via CourtListener.","version":"0.8.0","websiteUrl":null,"repositoryUrl":"https://github.com/cyanheads/courtlistener-mcp-server","remotes":[{"url":"https://courtlistener.caseyjhand.com/mcp","type":"streamable-http"}],"packages":[{"version":"0.8.0","identifier":"@cyanheads/courtlistener-mcp-server","runtimeHint":"stdio","registryType":"npm","runtimeArguments":null,"environmentVariables":null},{"version":"0.8.0","identifier":"@cyanheads/courtlistener-mcp-server","runtimeHint":"streamable-http","registryType":"npm","runtimeArguments":null,"environmentVariables":null}],"status":"active","isLatest":true,"publishedAt":"2026-10-18T09:04:38.320Z","updatedAt":"2026-10-18T09:04:38.320Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"stars":null,"title":null,"source":"official-registry","sourceId":"io.github.cyanheads/courtlistener-mcp-server","updatedAt":"2026-10-18T09:04:38.320Z","confidence":100,"websiteUrl":null,"description":"Search US court opinions, federal dockets, judges, citations, and oral arguments via CourtListener.","verification":"official","repositoryUrl":"https://github.com/cyanheads/courtlistener-mcp-server"}],"toolIndex":{"tools":[{"serverName":"io.github.cyanheads/courtlistener-mcp-server","endpointFingerprint":"f2673133737becc5058cb412170a17c6255bebb8516bec2725f4663582fde548","name":"courtlistener_get_citations","title":"Get Citation Network","description":"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.","inputSchema":{"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},"annotations":{"readOnlyHint":true,"idempotentHint":false,"openWorldHint":true},"definitionHash":"2e07479480a5f3ea2b28f942d8a7dd7c4d6de4b7937bba9116f0c4f87a86cab8","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:28.678Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/courtlistener-mcp-server","endpointFingerprint":"f2673133737becc5058cb412170a17c6255bebb8516bec2725f4663582fde548","name":"courtlistener_get_docket","title":"Get Docket","description":"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; continue retrieval.next_cursor as cursor with the same docket_id, entries_page 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.","inputSchema":{"type":"object","properties":{"document_ids":{"description":"Select RECAP document IDs embedded on entries_page. No other pages or document endpoints are fetched; omit for the unchanged docket listing.","minItems":1,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"cursor":{"description":"Retrieval next_cursor from the previous response. Repeat the original ID and sections/categories selection unchanged. Matching continuations can reuse source for five minutes from source_fetched_at; omit cursor to fetch fresh source.","type":"string","maxLength":1024},"docket_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Docket ID from a search result's docket_id field or from an opinion cluster result."},"entries_page":{"default":1,"description":"Docket entries use ascending entry number, 20 per page, up to page 100. Pass the numeric value of the top-level next_cursor as entries_page to continue. For a positive total_entries, ceil(total_entries / 20) locates the last page if it is at most 100. A null total gives no last-page calculation. Use filing dates to identify recent filings.","type":"integer","minimum":1,"maximum":9007199254740991},"entries_page_size":{"default":20,"description":"Requested docket entries per page. NOTE: CourtListener ignores this value — /docket-entries/ always returns a fixed 20-entry page regardless of what is passed. Use entries_page to reach entries beyond the first 20 (large cases can have hundreds).","type":"integer","minimum":1,"maximum":9007199254740991}},"required":["docket_id"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":true},"definitionHash":"d1f3670ef65de15d87b13e807336adda9475fb40945db5f8ab864b6a166f4c42","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:28.678Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/courtlistener-mcp-server","endpointFingerprint":"f2673133737becc5058cb412170a17c6255bebb8516bec2725f4663582fde548","name":"courtlistener_get_financial_disclosure","title":"Get Financial Disclosure","description":"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.","inputSchema":{"type":"object","properties":{"cursor":{"description":"Retrieval next_cursor from the previous response. Repeat the original ID and sections/categories selection unchanged. Matching continuations can reuse source for five minutes from source_fetched_at; omit cursor to fetch fresh source.","type":"string","maxLength":1024},"disclosure_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Financial disclosure ID — the disclosure_id field from a courtlistener_search_financial_disclosures result."},"categories":{"description":"Line-item categories to select. Omit for all. Oversized selections page; keep this selection unchanged while following cursor.","type":"array","items":{"type":"string","enum":["investments","debts","positions","reimbursements","non_investment_incomes","spouse_incomes","agreements","gifts"]}}},"required":["disclosure_id"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":true},"definitionHash":"2c58e6ca1fa045b0b84f0f3cf02ff76c4c90d56dff47f0e2142112cb9cebbb76","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:28.678Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/courtlistener-mcp-server","endpointFingerprint":"f2673133737becc5058cb412170a17c6255bebb8516bec2725f4663582fde548","name":"courtlistener_get_judge","title":"Get Judge Profile","description":"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.","inputSchema":{"type":"object","properties":{"person_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Judge person ID from a search result's person_id field. Identifies a specific judge across all courts they have served on."}},"required":["person_id"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":true},"definitionHash":"120566eaf25e52d54362510765c742e422e88eb29fd19ddfd33f9c3e88d8d0c5","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:28.678Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/courtlistener-mcp-server","endpointFingerprint":"f2673133737becc5058cb412170a17c6255bebb8516bec2725f4663582fde548","name":"courtlistener_get_opinion","title":"Get Court Opinion","description":"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.","inputSchema":{"type":"object","properties":{"cursor":{"description":"Retrieval next_cursor from the previous response. Repeat the original ID and sections/categories selection unchanged. Matching continuations can reuse source for five minutes from source_fetched_at; omit cursor to fetch fresh source.","type":"string","maxLength":1024},"text":{"default":"both","description":"Opinion text representation. Both is the default. Plain preserves supplied text or derives readable text from markup. Repeat this choice with continuation cursors.","type":"string","enum":["plain","html","both"]},"enrichment_cursor":{"description":"Continue enrichment_retrieval.next_cursor independently of primary cursor. A changed docket summary restarts only enrichment slices.","type":"string","maxLength":1024},"cluster_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Opinion cluster ID — identifies a case decision and groups all opinion variants (majority, concurrence, dissent). Obtain from courtlistener_search_opinions, courtlistener_lookup_citation, or from docket results that link to opinions."},"sections":{"description":"Opinion variant identifiers to select (e.g. [\"opinion_12345\"]). Omit for all fetched variants. Oversized selections page; keep this selection unchanged while following cursor.","type":"array","items":{"type":"string"}}},"required":["cluster_id"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":true},"definitionHash":"461aaa1d8b18d11015ab3a91c761bc8301211df0bbe2898dee8f0c5e83c27cc9","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:28.678Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/courtlistener-mcp-server","endpointFingerprint":"f2673133737becc5058cb412170a17c6255bebb8516bec2725f4663582fde548","name":"courtlistener_get_oral_argument","title":"Get Oral Argument","description":"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.","inputSchema":{"type":"object","properties":{"cursor":{"description":"Retrieval next_cursor from the previous response. Repeat the original ID and sections/categories selection unchanged. Matching continuations can reuse source for five minutes from source_fetched_at; omit cursor to fetch fresh source.","type":"string","maxLength":1024},"id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Audio recording ID — the audio_id field from a courtlistener_search_oral_arguments result."},"sections":{"description":"Selected record fields. Metadata is always selected; a nonempty selection omitting transcript excludes it. Omit for the whole record. Oversized selections page; keep this selection unchanged while following cursor.","type":"array","items":{"type":"string"}}},"required":["id"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":true},"definitionHash":"b6b1fdaf459a0ec6f3ca6e21f0388a37811f82f09388d877faef7fdae7734954","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:28.678Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/courtlistener-mcp-server","endpointFingerprint":"f2673133737becc5058cb412170a17c6255bebb8516bec2725f4663582fde548","name":"courtlistener_get_parties","title":"Get Parties","description":"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.","inputSchema":{"type":"object","properties":{"docket_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Docket ID from a courtlistener_search_dockets or courtlistener_get_docket result's docket_id field."},"cursor":{"description":"Pagination cursor from a previous response's next_cursor field. Omit for the first page. This is an opaque token, not a page number — CourtListener cursor-paginates this endpoint, so a numeric value selects nothing and re-serves the first page.","type":"string"},"page_size":{"default":10,"description":"Positive requested party page size (default 10), bounded to 10 before retrieval. CourtListener uses fixed 20-row pages and ignores this request; final pages can be smaller. page_sizing reports requested, bounded and actual sizes.","type":"integer","minimum":1,"maximum":9007199254740991}},"required":["docket_id"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":true},"definitionHash":"d116417962106c6d9191fbdafd2fecc5577fa369d6a68982b8376681bc9a7747","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:28.678Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/courtlistener-mcp-server","endpointFingerprint":"f2673133737becc5058cb412170a17c6255bebb8516bec2725f4663582fde548","name":"courtlistener_lookup_citation","title":"Lookup Legal Citation","description":"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.","inputSchema":{"type":"object","properties":{"citation":{"type":"string","description":"Text to extract citations from — normally a single citation (e.g., \"410 U.S. 113\", \"347 U.S. 483\", \"93 S. Ct. 705\"), but any passage works and every citation in it is resolved. Supports standard reporter formats. Up to 64000 characters, which is CourtListener's own ceiling; a longer passage is rejected here rather than spending a request to be refused upstream."},"max_court_lookups":{"default":4,"description":"How many distinct dockets this call may spend a request on to resolve cluster courts. The lookup itself is metered separately by CourtListener (per citation submitted), so this budget is drawn entirely from the ordinary per-request allowance — published free tier 5/min, 50/hour, 125/day, varying by token tier. 0 skips court resolution and costs nothing beyond the lookup; 20 is the ceiling. Clusters past the budget come back with court null and court_resolution \"over_budget\".","type":"integer","minimum":0,"maximum":20}},"required":["citation"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":true},"definitionHash":"a0037fb17087d46f33afdbffa769ea9a1ea41c0391faf3b5409b27a8f6c656b4","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:28.678Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/courtlistener-mcp-server","endpointFingerprint":"f2673133737becc5058cb412170a17c6255bebb8516bec2725f4663582fde548","name":"courtlistener_lookup_courts","title":"Lookup Courts","description":"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 the complete list of matching court IDs without paging whenever the filtered set fits the response budget, which covers the default bench and every jurisdiction filter. Full court records — names, citation strings, scraper status — come live from CourtListener at a fixed 20 rows per page, so pull those only when a court ID alone is not enough.","inputSchema":{"type":"object","properties":{"jurisdiction":{"description":"Jurisdiction type — CourtListener's own court classification, one code per court: F=Federal Appellate, FD=Federal District, FB=Federal Bankruptcy, FBP=Federal Bankruptcy Panel, FS=Federal Special, S=State Supreme, SA=State Appellate, ST=State Trial, SS=State Special, SAG=State Attorney General, TRS=Tribal Supreme, TRA=Tribal Appellate, TRT=Tribal Trial, TRX=Tribal Special, TS=Territory Supreme, TA=Territory Appellate, TT=Territory Trial, TSP=Territory Special, MA=Military Appellate, MT=Military Trial, C=Committee, I=International. Omit to list all. SCOTUS and the numbered circuits are F; USITC and FISC are FS. Upstream's Testing code is not offered here: /courts/ excludes testing courts from every response, so a filter on it can only ever return nothing. Accepted but matching no court as of the 2026-07-30 snapshot: TSP, MT. Courts whose stored jurisdiction is not one of these codes (njcirctsussex, ohctapp1) are unreachable through this filter at any value — the value they store is not one the filter accepts. Pass those ids straight to the tool that needs them, or list with no jurisdiction filter.","type":"string","enum":["F","FD","FB","FBP","FS","S","SA","ST","SS","SAG","TRS","TRA","TRT","TRX","TS","TA","TT","TSP","MA","MT","C","I"]},"status":{"default":"active","description":"Which bench to return. 'active' (default) returns only courts CourtListener currently scrapes; 'inactive' returns only the historical and defunct courts it no longer scrapes; 'any' returns both. The two filtered sets are disjoint, so 'any' is the only value that reaches the whole list — but reaching all of it means paging, one call per 20 courts, and the inactive bench is several times larger than the active one. Prefer the narrowest value that answers the question, and narrow with jurisdiction rather than paging the full list.","type":"string","enum":["active","inactive","any"]},"has_opinion_scraper":{"description":"Filter to courts with active opinion scraping. Useful when planning search queries — courts without scrapers have sparse coverage.","type":"boolean"},"page":{"default":1,"description":"Page number (1-indexed). CourtListener serves /courts/ at a fixed 20 rows per page and ignores any requested page size, so the number of pages is the enrichment totalCount divided by 20 — there is no way to pull a larger page. Pass the next_cursor from a previous response here to walk them one call at a time.","type":"integer","minimum":1,"maximum":9007199254740991}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":false,"openWorldHint":true},"definitionHash":"5a4515545224467d361ff18be69611f41c87f5d4fcc9d39ab88ecb8ad967cce7","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:28.678Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/courtlistener-mcp-server","endpointFingerprint":"f2673133737becc5058cb412170a17c6255bebb8516bec2725f4663582fde548","name":"courtlistener_search_dockets","title":"Search Federal Court Dockets","description":"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.","inputSchema":{"type":"object","properties":{"q":{"type":"string","description":"Query terms matched against case name, docket number, party names, and attorney names. Use \"*\" for a filter-only search."},"court":{"description":"Filter by one federal court ID or a space-separated list (e.g., \"cand cacd\"). Find IDs with courtlistener_lookup_courts.","type":"string"},"party_name":{"description":"Filter to dockets listing a specific party by name — applied in addition to (AND with) the q query. More precise than including party names in q when the party name is known.","type":"string"},"filed_after":{"description":"Earliest case filing date (ISO 8601).","type":"string"},"filed_before":{"description":"Latest case filing date (ISO 8601).","type":"string"},"include":{"description":"Select which indexed name arrays to include. Omit for counts only.","type":"array","items":{"type":"string","enum":["parties","attorneys","firms"]}},"page_size":{"default":20,"description":"Positive requested page size (default 20), bounded to 20. Upstream search has a 20-row minimum; empty and final pages can be smaller. Full pages and continuation are preserved; page_sizing reports actual sizes.","type":"integer","minimum":1,"maximum":9007199254740991},"cursor":{"description":"Pagination cursor from a previous response's next_cursor field.","type":"string"}},"required":["q"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":false,"openWorldHint":true},"definitionHash":"b35e2736ccfb9dc885a7f42193c4774030c8ac621c77abbe2d03b567ed86b796","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:28.678Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/courtlistener-mcp-server","endpointFingerprint":"f2673133737becc5058cb412170a17c6255bebb8516bec2725f4663582fde548","name":"courtlistener_search_financial_disclosures","title":"Search Financial Disclosures","description":"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.","inputSchema":{"type":"object","properties":{"judge_id":{"description":"Person ID of the judge whose disclosures to return — obtain from courtlistener_search_judges (the person_id field). Omit to browse across all filers.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"year":{"description":"Filing year to filter by (e.g., 2022). Applied client-side to the fetched page only — CourtListener rejects a server-side year param, so filings for this year on later pages are not included. When a page has no match for the year but more pages remain, next_cursor is returned; pass it as cursor to check the next page. Omit to return all years on the page.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"page_size":{"default":20,"description":"Positive requested page size (default 20), bounded to 20. Upstream has a minimum of 20; final pages and page-local year filtering can return fewer. Full fetched pages and continuation are preserved; page_sizing reports returned sizes.","type":"integer","minimum":1,"maximum":9007199254740991},"cursor":{"description":"Pagination cursor from a previous response's next_cursor field.","type":"string"}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":false,"openWorldHint":true},"definitionHash":"4f2ef529d616d205f30677ea7ba9298ae4dcfaa44d658f2c24b9c737fd19aa85","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:28.678Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/courtlistener-mcp-server","endpointFingerprint":"f2673133737becc5058cb412170a17c6255bebb8516bec2725f4663582fde548","name":"courtlistener_search_judges","title":"Search Judges","description":"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.","inputSchema":{"type":"object","properties":{"q":{"type":"string","description":"Search query for judge name, court, city, or keywords. Use \"*\" for a filter-only search."},"appointer":{"description":"Filter by appointing president's last name (e.g., \"Obama\", \"Trump\", \"Biden\"). Matches against the appointer field in position records.","type":"string"},"court":{"description":"Filter to judges who have held a position at one of these courts. Pass a court ID or a space-separated list (e.g., \"scotus ca9\"). Find IDs with courtlistener_lookup_courts.","type":"string"},"political_affiliation":{"description":"Filter by political affiliation: d=Democrat, r=Republican, i=Independent, l=Libertarian, g=Green Party, u=Unknown/unconfirmed. Based on party of the appointing president or election affiliation.","type":"string","enum":["d","r","i","l","g","u"]},"page_size":{"default":20,"description":"Positive requested page size (default 20), bounded to 20. Upstream search has a 20-row minimum; empty and final pages can be smaller. Full pages and continuation are preserved; page_sizing reports actual sizes.","type":"integer","minimum":1,"maximum":9007199254740991},"cursor":{"description":"Pagination cursor from a previous response's next_cursor field.","type":"string"}},"required":["q"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":false,"openWorldHint":true},"definitionHash":"66755c69e4cd389277af130707e483d60cc9006d436f8ffa45571778268bf72b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:28.678Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/courtlistener-mcp-server","endpointFingerprint":"f2673133737becc5058cb412170a17c6255bebb8516bec2725f4663582fde548","name":"courtlistener_search_opinions","title":"Search Court Opinions","description":"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.","inputSchema":{"type":"object","properties":{"q":{"type":"string","description":"Full-text query. Use \"*\" for a filter-only search. Supports field syntax (caseName:\"roe v wade\", court_id:scotus, judge:\"Alito\") and boolean operators (AND, OR, NOT)."},"court":{"description":"Filter by one court ID or a space-separated list (e.g., \"scotus ca9\"). Use courtlistener_lookup_courts to find court IDs.","type":"string"},"filed_after":{"description":"Earliest filing date (ISO 8601, e.g., \"2020-01-01\"). Narrows search to opinions filed on or after this date.","type":"string"},"filed_before":{"description":"Latest filing date (ISO 8601). Narrows search to opinions filed before or on this date.","type":"string"},"status":{"description":"Opinion publication status. \"Published\": precedential. \"Unpublished\": not citable as precedent in most jurisdictions. \"Errata\": corrections. \"Separate\": separate opinion filed outside main cluster. \"In-chambers\": single-justice order. \"Relating-to\": companion or related-case order. Omit to use CourtListener’s Published default.","type":"string","enum":["Published","Unpublished","Errata","Separate","In-chambers","Relating-to","Unknown"]},"order_by":{"default":"score desc","description":"Result ordering. \"score desc\" (default) ranks by relevance. \"citeCount desc\" surfaces most-cited opinions first.","type":"string","enum":["score desc","dateFiled desc","dateFiled asc","citeCount desc"]},"page_size":{"default":20,"description":"Positive requested page size (default 20), bounded to 20 before retrieval. Upstream search has a 20-row minimum; empty and final pages can be smaller. Full upstream pages and continuation are preserved; page_sizing reports requested, bounded and actual sizes.","type":"integer","minimum":1,"maximum":9007199254740991},"cursor":{"description":"Pagination cursor from a previous response's next_cursor field. Omit for the first page.","type":"string"},"include":{"description":"Include cited opinion IDs for each variant with [\"cites\"].","type":"array","items":{"type":"string","enum":["cites"]}}},"required":["q"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":false,"openWorldHint":true},"definitionHash":"2cc2a5f3b58c77d4e52b907dde34eade045dec7527e237d639f649e0c339d2f8","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:28.678Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/courtlistener-mcp-server","endpointFingerprint":"f2673133737becc5058cb412170a17c6255bebb8516bec2725f4663582fde548","name":"courtlistener_search_oral_arguments","title":"Search Oral Arguments","description":"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.","inputSchema":{"type":"object","properties":{"q":{"type":"string","description":"Query terms matched against case name and transcribed argument text. Use \"*\" for a filter-only search."},"court":{"description":"Filter by one court ID or a space-separated list (e.g., \"scotus ca9\"). Find IDs with courtlistener_lookup_courts.","type":"string"},"argued_after":{"description":"Earliest date the case was argued (ISO 8601) — filters by argument date, not publication date.","type":"string"},"argued_before":{"description":"Latest date the case was argued (ISO 8601).","type":"string"},"page_size":{"default":20,"description":"Positive requested page size (default 20), bounded to 20. Upstream search has a 20-row minimum; empty and final pages can be smaller. Full pages and continuation are preserved; page_sizing reports actual sizes.","type":"integer","minimum":1,"maximum":9007199254740991},"cursor":{"description":"Pagination cursor from a previous response's next_cursor field.","type":"string"}},"required":["q"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":false,"openWorldHint":true},"definitionHash":"3f611cde26360a0425565fad1dcf566438e84b7c2d9a18e5086e9e628f938ec7","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:28.678Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"f2673133737becc5058cb412170a17c6255bebb8516bec2725f4663582fde548","protocol":"streamable-http","status":"indexed","toolCount":14,"observedAt":"2026-11-19T07:46:28.678Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"io.github.cyanheads/courtlistener-mcp-server":{"url":"https://courtlistener.caseyjhand.com/mcp"}}},"Cursor":{"mcpServers":{"io.github.cyanheads/courtlistener-mcp-server":{"url":"https://courtlistener.caseyjhand.com/mcp"}}},"VS Code":{"servers":{"io.github.cyanheads/courtlistener-mcp-server":{"type":"http","url":"https://courtlistener.caseyjhand.com/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://courtlistener.caseyjhand.com/mcp"},{"protocol":"mcp","package":"@cyanheads/courtlistener-mcp-server","registryType":"npm","version":"0.8.0"},{"protocol":"mcp","package":"@cyanheads/courtlistener-mcp-server","registryType":"npm","version":"0.8.0"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:io.github.cyanheads%2Fcourtlistener-mcp-server","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/io.github.cyanheads%2Fcourtlistener-mcp-server","name":"io.github.cyanheads/courtlistener-mcp-server","description":"Search US court opinions, federal dockets, judges, citations, and oral arguments via CourtListener.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://courtlistener.caseyjhand.com/mcp"},{"protocol":"mcp","package":"@cyanheads/courtlistener-mcp-server","registryType":"npm","version":"0.8.0"},{"protocol":"mcp","package":"@cyanheads/courtlistener-mcp-server","registryType":"npm","version":"0.8.0"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":null,"repositoryUrl":"https://github.com/cyanheads/courtlistener-mcp-server","version":"0.8.0"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"io.github.cyanheads/courtlistener-mcp-server","status":"online","lastCheckedAt":"2026-11-20T09:18:00.745Z","lastSuccessfulCheck":"2026-11-20T09:18:00.745Z","latencyMs":284,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T09:18:00.745Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T09:18:00.745Z"},"security":null,"timestamps":{"createdAt":"2026-10-18T09:04:38.320Z","updatedAt":"2026-10-18T09:04:38.320Z","observedAt":"2026-11-20T09:18:00.745Z"},"compatibility":{"serverVersion":"0.8.0","protocolVersions":[{"protocol":"mcp","version":null}]}}}}