Ask the statistics office (sandbox)
file_revision_inquiryFiles a tracked inquiry with the statistics office about an unexplained revision to a federal court figure, joining an existing inquiry if one is open. Sends only after user confirms.
Instructions
Use this when the user picked "Ask the statistics office why this changed" for a figure in a saved answer: a figure that was revised between editions with no published explanation (e.g. FY2020 national weighted civil filings per judgeship, 554 → 322). It files one inquiry per revision; if someone already asked, the request joins that inquiry instead.
Not for figures that weren't revised or whose revision is routine (pending counts restated in Table C-1); get_official_figure shows a figure's revision_notes first. Not for free-text messages: an inquiry is always about one revision.
Returns the inquiry, how many requests wait on it, and where it would go (AO Statistics Division for published tables). Sandbox: nothing is sent. Writes only after the user confirms.
Example: request_id=1001, measure='weighted_civil_filings_per_judgeship', court='US', fiscal_year=2020 → inquiry #1, waiting_for_office.
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": {
"request_id": "<request_id>",
"measure": "<measure>",
"fiscal_year": "<fiscal_year>"
},
"name": "file_revision_inquiry"
}
}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 |
| confirm | No | True once the user has agreed to this write. False (default) asks the user, or returns a preview if the client can't ask. | |
| measure | Yes | A published statistic (see courts://glossary or explain_term for definitions). | |
| asker_name | No | A display name for the asker (demo identity; the same name must be used for every call about one request). | MCP user |
| request_id | Yes | The request. | |
| fiscal_year | Yes | ||
| idempotency_key | No | Any unique string; a retried call with the same key returns the first result instead of writing again. |
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. |