forecast

What it does

Forecasts forecast in the local Clovis ledger.

Signature(account_id: string, as_of?: string | null, asset_id?: string | null) => 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.

Use it for budgets, goals, forecasts, month-end projections, runway, or cash planning.

Agents should gather these facts or confirmations first.

1

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.

as_ofoptional

string | null

Date to calculate balances through, usually YYYY-MM-DD.

Default: null

asset_idoptional

string | null

Asset or currency id used by the ledger.

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": "forecast",
  "arguments": {
    "account_id": "<account_id>"
  }
}

CategoryPlanning and cash flow

ReturnsobjectReturns object from the local ledger.

Aliasesasset -> asset_id