Read a case
get_caseFetch one case: metadata, parallel citations, treatment flag, and full opinion text (paginated via offset/max_chars). cited_by is the number of opinions citing the case: CourtListener's count, or the syfert.com citation graph's when that finds more (cited_by_source: citation_graph says so); for a decision filed as several twin clusters it is summed over them (cited_by_note says so), and a duplicate or stub twin id is answered with its survivor (note says so). Citations inside the returned text are checked against the reporter index (embedded_citations); citation_warnings names any the court itself got wrong. Identify the case by cluster_id (from search_cases results) or by reporter citation. find_text returns passages: up to 5 sentence-bounded windows holding a phrase (or its closest match) with star_page and offset, so a long opinion need not be paged (pass include_text=false to get only those); quotable=true adds quotable_passages, the passages of this opinion other courts quote. Quotation marks mean pasted from a tool result (opinion text, passage, best_match). If you typed a quote from memory, run verify_quote and use best_match. Run check_brief on the finished draft and apply its corrections. Copy cite_as for the citation (first page, then pin). A California Court of Appeal opinion with a Supreme Court docket event carries citability {status depublished | review_granted | transferred | review_decided, date, s_number, source, rule Cal. R. Ct. 8.1115}; depublished / review granted / transferred lead with status_warning (a depublished opinion may not be cited; one under review has no binding effect, is citable for persuasive value and to establish a conflict in authority, and the cite must note the grant; one transferred with directions to vacate is generally not citable; order_says quotes the order when held); old_rule true = review granted before 2016-07-01, when the grant itself depublished the opinion (a later decision did not restore it): may_cite no, check the docket. focus = a question or proposition in plain words (no brief sentence needed): returns focus_passages, the 4 (focus_n, at most 8) passages of about 2,000 characters that bear on it most, each with page, offset, lexical score and part (majority / concurrence / dissent / syllabus ...), instead of reading from the opening; opinion text is then left out unless include_text=true. focus_miss=true means no passage matched (nothing else is returned). With pin, the first passage is the pinned page's own best window.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_case"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pin | No | With focus: the page you cite ("1250" or "1250-51"); the first focus passage is then that page's best window (source: pin) and the ranked passages follow | |
| focus | No | A question or proposition in plain words, e.g. "whether a FOIA fee waiver requires a public-interest showing": returns focus_passages (placed by word overlap, ranked; the rest of the opinion is not returned) | |
| offset | No | Character offset for paging long opinions (use next_offset from a prior call) | |
| focus_n | No | With focus: passages to return (default 4, at most 8) | |
| citation | No | Reporter citation, e.g. "819 So. 2d 732" (used if cluster_id absent) | |
| quotable | No | With include_text, also return quotable_passages: the passages of this opinion other courts quote, with star_page | |
| case_name | No | Case name; used only when the citation is not in the reporter index (newer than it): resolves by name + decision-date window and returns candidates if several cases share the name | |
| find_text | No | A phrase to locate in the opinion: returns passages (exact, or the closest match) with star_page and offset | |
| max_chars | No | Max characters of opinion text to return (default 40000, max 150000) | |
| cluster_id | No | Cluster id from search results | |
| forum_state | No | Optional two-letter state code of the court you file in (il, ga, tx ... dc). Adds forum_cite to every case: the citation in the form that state's courts use for their own reports (other cases in Bluebook form), pinned where cite_as is. | |
| include_text | No | Include opinion text (default true) |