Documentation

project_month_end

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

npm

What it does

Projects month end in the local Clovis ledger.

Signature(year?: number | null, month?: number | null, expected_inflows?: Array<Record<string, unknown>> | null, expected_outflows?: Array<Record<string, unknown>> | null, expected_paychecks?: Array<Record<string, unknown>> | null, include_pending?: boolean, include_planned?: boolean, account_ids?: string[] | null, asset_account_ids?: string[] | null, liability_account_ids?: string[] | null, quote_asset_id: string) => Record<string, unknown>
read-only

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

When to use it

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.

Before calling

Agents should gather these facts or confirmations first.

1

Have exact values for required inputs: quote_asset_id.

2

Choose the report currency or asset explicitly; Clovis does not infer report currency.

Parameters

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

yearoptional
integer | null

Four-digit year.

Default: null
monthoptional
integer | null

Month number from 1 to 12.

Default: null
expected_inflowsoptional
object[] | null

Expected incoming cash items for projection.

Default: null
expected_outflowsoptional
object[] | null

Expected outgoing cash items for projection.

Default: null
expected_paychecksoptional
object[] | null

Expected paycheck or income items for projection.

Default: null
include_pendingoptional
boolean

Includes pending transactions in the calculation.

Default: true
include_plannedoptional
boolean

Includes planned transactions in the calculation.

Default: true
account_idsoptional
string[] | null

List of ledger account ids or account references.

Default: null
asset_account_idsoptional
string[] | null

Asset account ids to include in a projection.

Default: null
liability_account_idsoptional
string[] | null

List of identifiers from the local Clovis ledger.

Default: null
quote_asset_idrequired
string

Asset or currency used to quote report values. Clovis does not infer this.

Agent call shape

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

project_month_end

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

{
  "tool": "project_month_end",
  "arguments": {
    "quote_asset_id": "USD"
  }
}

Metadata