Documentation

top_descriptions

top_descriptions MCP tool reference, parameters, return type, and safety hints.

What it does

Shows descriptions in the local Clovis ledger.

Signature(account_id: string, limit?: number, status?: string | null) => Array<Record<string, unknown>>

read-only

Read-only. This is appropriate for inspection, reporting, diagnostics, and first-pass agent answers.

Use this section to decide whether the tool fits the user request before calling it.

Use it when an agent needs to inspect the ledger or answer a question without changing records.

Agents should gather these facts or confirmations first.

Have exact values for required inputs: account_id.

Required inputs are marked clearly. Optional inputs can usually be omitted unless the workflow needs them.

account_idrequired

string

Ledger account id or resolvable account reference.

limitoptional

integer

Maximum number of rows to return.

Default: 50

statusoptional

string | null

Transaction status filter or value: posted, pending, planned, or void.

Default: null

Use the exact tool name and pass arguments as structured JSON through the MCP client.

Copy this shape into agent instructions, evals, or MCP client tests.

{
  "tool": "top_descriptions",
  "arguments": {
    "account_id": "<account_id>"
  }
}

CategoryCore tools

Returnsobject[]Returns object[] from the local ledger.

AliasesNone