update_card_limit - Agentcard

Connect to https://mcp.agentcard.sh/mcp with the user’s connection token (or a buy_token for org-owned accounts). Behavior: idempotent.

What it does

Change a multi-use card’s total spending limit. Raising it reserves the extra amount from the user’s cash balance (top up with add_funds if short); lowering it frees the difference, but the new limit can never go below what the card has already spent. Single-use cards cannot be resized.

Inputs

Field	Type	Description
`card_id` (required)	string	The multi-use card ID to resize.
`approval_id`	string	Approval id from a prior approval_required response, once the user has approved. Only for cards created through ANOTHER app: first call without it (the user is emailed an approve link), then retry with it.
`spend_limit_cents`	number	The new TOTAL spending limit in cents (minimum 100). This is the lifetime cap, not a delta: a card that spent $20 of a $50 limit, resized to 8000, can spend $60 more.
`new_limit_cents`	number	Deprecated alias for spend_limit_cents. Prefer spend_limit_cents (matches the docs and the REST API).

Returns

Field	Type	Description
`message` (required)	string	Human-readable result.
`status`	string	”updated” on success; an error discriminator otherwise (e.g. “limit_below_spent”, “insufficient_collateral”).
`cardId`	string	The card ID.
`spendLimitCents`	number	The new total limit in cents.
`balanceCents`	number	The remaining spendable balance in cents.

Example call

{
  "tool": "update_card_limit",
  "arguments": {
    "card_id": "\u2026"
  }
}