Open a request (sandbox)
open_requestCreate a request on the sandbox request desk to ask the statistics office why a figure changed, save a verified copy, or receive alerts when its numbers change; user confirmation required.
Instructions
Use this only when the user explicitly asks to keep an answer: to ask the statistics office why a figure changed (option 'ask_office'), to save a verified copy ('verified_copy'), or to be notified if its numbers change ('notify'). It creates a request on the sandbox request desk. Answering a question never needs it; never call it on your own initiative.
Not for answering questions (use get_official_figure, explain_change and the other read tools) or for saving the answer text (call save_verified_answer next, with the answer and its citations).
Returns the new request: its number, status and inbox updates. It writes only after the user confirms; without confirmation it returns a preview. Sandbox: nothing is sent to the AO or the FJC.
Example: option='ask_office', question='Why did FY2020 national weighted civil filings per judgeship change from 554 to 322?' → request #1001, status 'received'.
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": {
"option": "<option>",
"question": "<question>"
},
"name": "open_request"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| option | Yes | What the user wants kept. | |
| 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. | |
| question | Yes | The user's question. | |
| 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 |
| asker_role | No | Who is asking. | public |
| 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. |