CourtListener

Get the number of results from a previous query. Some endpoints return the count lazily. Use this tool to retrieve the count from a previous query if it is not available.

get_counts

Request a RECAP document that is not yet available on CourtListener through Pray and Pay. Prayers are pooled across users: when anyone buys the document from PACER, it is added to CourtListener for free and everyone praying for it is emailed. Nothing is charged to the user, but fulfillment is not immediate and not guaranteed. Only documents whose `is_available` is false need a prayer. This tool checks first and, if the document is already available, tells you to read it with `read_document` instead. Prayers count against a daily per-user limit, so only pray when the user actually wants the filing. Use `call_endpoint` with endpoint_id "prayers" to list the user's pending prayers.

pray_for_document

Read the full text of a court opinion or RECAP document. Fetches the document text and either returns it in full or as one or more paginated chunks. For opinions, uses the ``html_with_citations`` field (the most complete text representation). For RECAP documents, uses ``plain_text``. **Usage patterns** - *Full read*: omit ``chunk_index`` to receive the entire document along with its ``total_chars``. - *Single chunk*: pass an integer ``chunk_index`` (0-based) to receive one window of ``chunk_size`` characters. The response includes ``total_chunks`` so you can jump directly to any part of the document (e.g. set ``chunk_index`` to ``total_chunks - 1`` to read the conclusion). - *Multiple chunks*: pass a list of chunk indexes to retrieve several non-contiguous windows in a single call (up to 10). Useful when you already know the chunk size from a previous call and want the next N pages at once. Input should include exactly one of opinion_id, recap_document_id, or cluster_id.

read_document

Resume verifying citations from a previous analysis. Use this after analyze_citations returns with pending citations due to rate limiting (more than 250 unique case citations). Takes the job_id and verifies the next batch.

resume_citation_analysis

Search for case law, dockets, judges, and oral arguments. When returning results to the user, consider presenting them as color-coded visual cards with clickable "view on CourtListener" links rather than plain text, grouping by relevance or significance where helpful. Fields like `absolute_url`, `caseName`, `dateFiled`, etc. can be useful here.

search

Search for snippets within one or more court opinions or RECAP documents. Performs a case-insensitive literal search (similar to grep) and returns up to 20 matching excerpts per document with surrounding context. Use this to locate specific language—a party name, a statutory citation, a key phrase—without reading whole documents. Pass a list of IDs (up to 10) to search several documents in a single call. Results are returned as a list; errors on individual documents are included as an ``error`` field so one unavailable document does not abort the rest. When ``match_count`` exceeds ``shown``, the first 20 matches are returned. Use ``read_document`` with ``chunk_index`` to read the area around a match's ``position`` if you need more context. Input should include exactly one of opinion_id, recap_document_id, or cluster_id.

search_document

Subscribe to alerts for a docket on CourtListener. Use `call_endpoint` with endpoint_id "docket-alerts" to list existing subscriptions.

subscribe_to_docket_alert

Unsubscribe from alerts for a docket on CourtListener. Looks up the alert by docket ID and deletes it, so you only need the docket ID (not the alert ID). Use `call_endpoint` with endpoint_id "docket-alerts" to list existing subscriptions.

unsubscribe_from_docket_alert

Withdraw a pending Pray and Pay request for a RECAP document. Looks up the user's pending prayer by RECAP document ID and deletes it, so you only need the document ID (not the prayer ID). Prayers that have already been granted cannot be withdrawn and do not need to be: the document is available. Use `call_endpoint` with endpoint_id "prayers" to list the user's pending prayers.

withdraw_prayer