Explain a change
explain_changeExplain why federal court statistics rose or fell between two fiscal years, with exact breakdowns by district and case type and labeled drivers.
Instructions
Use this when the user asks why a number went up or down, or what drove a change between two fiscal years: "Why did civil filings jump in FY2020?", "what drove the drop in terminations", "break the change down by district and case type". Works for civil cases filed, terminated and pending, and for filings per judgeship (weighted or unweighted).
Not for a single year's figure (use get_official_figure) or a ranking (use compare_courts).
Returns the official change (Table C-1 or X-1A), breakdowns by district and by case type that sum exactly to the change, the change excluding directly filed MDL cases (filings), and drivers, each labelled by what backs it: official, idb_derived, inferred (our reasoning, not an official statement: say so) or context. A plain "civil filings" means civil_cases_filed (the count); pass measure='civil_filings' only when the user asks about workload without saying count or per judgeship.
Example: measure='civil_cases_filed', court='US', period_from=2019, period_to=2020 → +172,704; N.D. Fla. +199,881, driven by directly filed MDL cases (MDL 2885, 3M earplugs).
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>",
"period_from": "<period_from>",
"period_to": "<period_to>"
},
"name": "explain_change"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| court | No | Court code: US (all district courts), a circuit (CIR-01 … CIR-11, CIR-DC) or a district (state postal code, plus -N/-E/-S/-W/-M/-C for divided states: FL-N = N.D. Fla., NY-S = S.D.N.Y., DC = D.D.C.). | US |
| 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. | |
| period_to | Yes | Later fiscal year. | |
| period_from | Yes | Earlier fiscal year. |
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. |