`get_finance_ledger_verify`

Read-only

Calls GET /api/finance/ledger/verify as the signed-in person · REST reference

Verify the ledger journal's hash chain and latest checkpoint (platform staff)

Walks the append-only ledger journal from its first entry, recomputing every hash, and names the first entry that does not follow from the one before it. Also compares the latest checkpoint written to the Object Lock archive with the journal entry at the checkpoint's seq. Reads only.

Arguments

This tool takes no arguments.

Example call

A client sends this over the MCP session; Claude and other agents build it for you. The values are placeholders — the shape is real.

json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_finance_ledger_verify",
    "arguments": {}
  }
}

Result

On success (HTTP 200) the tool returns one text item holding the API's JSON, pretty-printed.

What the walk found

json

{
  "brokenAtSeq": 1,
  "checkpoint": {
    "entriesKey": "string",
    "hash": "string",
    "matches": true,
    "seq": 1,
    "writtenAt": "2026-01-15T12:00:00Z"
  },
  "headHash": "string",
  "headSeq": 1
}

Fields

Field	Type	Description
`brokenAtSeq`	integer \| null	Seq of the first entry that does not verify; null when every link held
`checkpoint`	object \| null	The latest checkpoint; null when none is written or no archive bucket is configured
`checkpoint.entriesKey`	string	Archive object holding the entries this checkpoint sealed
`checkpoint.hash`	string
`checkpoint.matches`	boolean	Whether the journal entry at `seq` has the checkpoint's hash
`checkpoint.seq`	integer
`checkpoint.writtenAt`	string (date-time)
`headHash`	string	Hash of that entry
`headSeq`	integer	Seq of the last entry that verified (0 for an empty journal)

When it fails

A failed call returns isError: true with the API's message as text.

403: Not platform staff

What the model is shown

This is the tool exactly as the server lists it in tools/list. The description starts with the REST call it makes.

json

{
  "name": "get_finance_ledger_verify",
  "description": "GET /api/finance/ledger/verify — Walks the append-only ledger journal from its first entry, recomputing every hash, and names the first entry that does not follow from the one before it. Also compares the latest checkpoint written to the Object Lock archive with the journal entry at the checkpoint's seq. Reads only.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "annotations": {
    "readOnlyHint": true,
    "openWorldHint": false
  }
}