Compare courts
compare_courtsCompare or rank federal district courts by a chosen workload measure and fiscal year, returning ranked results from one official edition.
Instructions
Use this when the user wants courts compared or ranked on one published measure in one fiscal year: "the five districts with the highest weighted filings per judgeship in FY2024", "compare S.D.N.Y., E.D.N.Y. and D.N.J.", "which Fifth Circuit districts are busiest".
Not for a single court's figure (use get_official_figure) or for why a court's number changed (use explain_change). Weighted filings come only from the official tables here.
Returns ranked rows (rank, court, value), all from one edition and table, plus the national figure from the same edition and, when a later edition revised the national figure, that one too with a warning. Omit courts to rank all districts; a circuit code ranks its districts. order='asc' for lowest first (for example fastest median times).
Example: measure='weighted_total_filings_per_judgeship', fiscal_year=2024, top_n=5 → N.D. Fla. 4,357, E.D.N.C. 834, E.D. Cal. 790, … (JB-2024 X-1A).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"measure": "<measure>",
"fiscal_year": "<fiscal_year>"
},
"name": "compare_courts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| order | No | desc | |
| top_n | No | ||
| courts | No | Courts to compare; omit for every district. A circuit code means its districts. | |
| edition | No | Which edition's figure to return: 'latest' (default: the current official figure), 'first_published', or a specific edition such as JB-2020 or JFF-2023. | latest |
| measure | Yes | A published statistic. If the user didn't say whether they mean weighted or unweighted filings, pass 'filings_per_judgeship' (or 'civil_filings') and the server will ask them. | |
| fiscal_year | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| status | No | ok | |
| declined | No | ||
| warnings | No | ||
| provenance | No | ||
| clarification | No | ||
| suggested_next | No | Hints for a follow-up call. |