Save a verified answer (sandbox)
save_verified_answerValidate an answer's figures against cited official values and server read-tool results; save it to the request only after checks pass and the user confirms. Returns issues if checks fail.
Instructions
Use this after open_request, when the user wants the answer kept: it checks the answer and saves it to the request only if it passes. The check: every number in the text is a cited official value, a number the server's read tools produce (pass the calls the answer relied on in tool_calls; the server re-runs them), a published threshold such as 430, or a difference or percentage of backed numbers; each citation matches what its edition printed; and one measure's figures come from consistent editions. An earlier edition's value may be quoted as history in a sentence that says so ("first published as 554").
Not for creating the request (use open_request) or for asking why a figure changed (use file_revision_inquiry after saving).
Returns whether it was saved and, if not, each problem with the number and what to write instead. Writes only after the user confirms.
Example: text='322 in FY2020 and 318 in FY2021 (JFF-2024)', citations for both → saved; quoting 554 (JB-2020) beside 318 (JFF-2024) → refused, mixed editions.
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>",
"text": "<text>",
"citations": "<citations>"
},
"name": "save_verified_answer"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | The answer. | |
| 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. | |
| citations | Yes | One entry per 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 |
| request_id | Yes | From open_request. | |
| 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. | |
| 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. |