Wallet & payouts

These 10 tools are always registered — no feature flag gates them.

get_balance

Returns the current ARS balance.

Parameters: none.

{ "asset": "ARS", "available": "125430.50" }

get_cvu

Returns the CVU (and alias, if any) to receive transfers.

Parameters: none.

{ "cvu": "0000003100010000123456", "alias": "" }

list_recent_deposits

Lists incoming transfers.

Parameter	Type	Required	Description
`limit`	integer		Max results, 1–50. Default `10`.

{
  "transfers": [
    { "id": "...", "from": "...", "to": "...", "amount": "5000.00", "currency": "ARS", "status": "completed", "creationTime": "2026-07-18T10:00:00Z", "direction": "credit" }
  ],
  "count": 1
}

list_recent_payouts

Lists the user’s payout attempts and their status.

Parameter	Type	Required	Description
`limit`	integer		Max results, capped at 50. Default `10`.

{
  "payouts": [
    { "id": "...", "amount_ars": 5000, "destination": "...", "destination_kind": "CBU", "status": "submitted", "decision": "allow", "created_at": "...", "resolved_at": null }
  ],
  "count": 1
}

get_payout_status

Looks up a single payout attempt by ID.

Parameter	Type	Required	Description
`payout_id`	string	✓	UUID of the payout attempt

Returns the same shape as one entry from list_recent_payouts.

get_thresholds

Reads the current policy thresholds. See Policy engine for how they’re used.

Parameters: none.

{
  "per_tx_limit_ars": 100000,
  "daily_limit_ars": 300000,
  "monthly_limit_ars": 2000000,
  "require_approval_above_ars": 500000,
  "whitelist_cbus": []
}

request_payout

Requests a payout. Goes through the policy engine — may execute immediately or trigger a WhatsApp/Telegram approval. See Policy engine and Approval flow.

Parameter	Type	Required	Description
`amount`	number	✓	Amount in ARS
`destination`	string	✓	CBU, CVU, or alias
`destination_kind`	string		`CBU` \| `CVU` \| `ALIAS`. Default `CBU`.
`note`	string		Free-text note attached to the payout
`idempotency_key`	string	✓	Unique key — a UUID is recommended

Executed immediately (decision: "allow"):

{ "id": "b3f1...", "status": "submitted", "decision": "allow" }

Requires approval (decision: "require_approval"):

{ "id": "b3f1...", "status": "pending_approval", "decision": "require_approval", "approval_id": "9a02...", "expires_in": 300 }

Denied outright returns an MCP tool error (isError: true) with a message like payout denied: kyc_incomplete.

propose_threshold_change

Proposes a threshold change. This always requires WhatsApp confirmation from the owner — it never applies directly, unlike PUT /v1/thresholds on the REST API.

Parameter	Type	Required	Description
`field`	string	✓	One of `per_tx_limit_ars`, `daily_limit_ars`, `monthly_limit_ars`, `require_approval_above_ars`
`value`	number	✓	New value in ARS
`note`	string		Optional context

Returns a plain-text confirmation that the WhatsApp message was sent — not JSON.

list_pending_approvals

Lists approvals awaiting a WhatsApp/Telegram reply.

Parameters: none.

{
  "pending_approvals": [
    { "ID": "9a02...", "PayoutAttemptID": "b3f1...", "SentAt": "...", "ExpiresAt": "..." }
  ],
  "count": 1
}

get_receipt

Returns receipt data for a completed payout.

Parameter	Type	Required	Description
`payout_id`	string	✓	UUID of the payout attempt

{
  "payout_id": "b3f1...",
  "status": "submitted",
  "amount_ars": 5000,
  "date": "2026-07-18T10:00:00Z",
  "destination": "0000003100010000123456",
  "destination_kind": "CBU",
  "from_email": "you@example.com",
  "from_cvu": "0000003100010000654321",
  "receipt_url": "https://sandbox-api.nuez.app/v1/withdraws/b3f1.../receipt"
}