Keep this answer (sandbox)
keep_answerValidate and save an answer you just gave; optionally file an office inquiry about a changed figure, store a verified copy, or set change notifications.
Instructions
Use this when the user asks to keep an answer you just gave: to ask the statistics office why a figure changed ('ask_office'), to save a verified copy ('verified_copy'), or to be told if its numbers change ('notify'). It checks the answer and, only if it passes, creates the request, saves the answer and (for 'ask_office') files the inquiry. Never call it on your own initiative.
Not for answering questions (use the read tools), for checking if a figure can go to the office (use check_inquiry_eligibility), or for following up (use my_requests).
Returns whether it was saved; if not, each problem with the number and the fix; if so, the request, inquiry and stamp to quote. Pass the answer's citations and the read tools it used (tool_calls). confirm=false writes nothing and returns a preview_id: describe the save, ask 'Shall I go ahead?', and only after a yes call with confirm=true and that preview_id. Changed text, or a retry after a refusal, needs a new preview. Sandbox: nothing reaches the AO or FJC.
Example: option='ask_office', inquiry={measure: 'weighted_civil_filings_per_judgeship', fiscal_year: 2020}, an answer quoting 322 (JFF-2025) and 554 (JB-2020) → saved, inquiry #1.
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>",
"answer_text": "<answer_text>",
"citations": "<citations>"
},
"name": "keep_answer"
}
}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. | |
| inquiry | No | For 'ask_office': the revised figure to ask about. | |
| question | Yes | The question. | |
| citations | Yes | Each official figure the answer quotes, with the edition it was quoted from. | |
| 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 |
| preview_id | No | With confirm=true: the preview_id from the confirm=false call the user said yes to. | |
| tool_calls | No | The read tools the answer relied on (name and arguments, e.g. explain_change with its arguments). The server re-runs them; numbers their outputs hold count as backed. Never send values. | |
| answer_text | Yes | The answer. | |
| 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. |