recover_funds

Connect to https://mcp.agentcard.sh/mcp with your organization credential (client_id + client_secret, or the org access token).

What it does

Recover a cardholder’s residual company-funded spending power back into your company wallet — for users you won’t fund again (for everyone else, closed-card balances net automatically against their next card). Omit amount_cents to recover the full current headroom. Live recoveries are fulfilled by the AgentCard team and complete asynchronously (recovery.completed webhook); sandbox completes instantly. Supports an idempotency_key.

Inputs

Field	Type	Description
`cardholder_id` (required)	string	The cardholder whose headroom to recover
`amount_cents`	number	Amount in cents; omit to recover the full current headroom
`idempotency_key`	string	Optional key making retries safe (Stripe semantics)

Returns

Field	Type	Description
`message` (required)	string	Human-readable outcome.
`recovery`	object	The recovery (id, status, amount_cents, cardholder_id, …).

Example call

{
  "tool": "recover_funds",
  "arguments": {
    "cardholder_id": "\u2026"
  }
}

MCP

Organization tools

User tools

What it does

Inputs

Returns

Example call

​What it does

​Inputs

​Returns

​Example call

What it does

Inputs

Returns

Example call