close_card

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

What it does

Permanently close a virtual card. This is irreversible — the card cannot be reopened. Safe to call on an already-closed card (idempotent). The user’s rewards card (the card their tokenback redeems onto) is close-protected: closing it returns its balance to the wallet but retires the card number the user may have on file at AI labs, so it requires confirm_rewards_card — set it ONLY after the user explicitly confirms they want the rewards card closed.

Inputs

Field	Type	Description
`card_id` (required)	string	The card ID to close
`confirm_rewards_card`	boolean	Required to close the rewards card. Only set after the user explicitly confirms; never set it preemptively.
`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.

Returns

Field	Type	Description
`message` (required)	string	Human-readable confirmation that the card was closed.
`approvalId`	string	Present when status is approval_required: pass it back as approval_id after the user approves.
`cardId`	string	The ID of the card that was closed.
`status`	string	Outcome discriminator; always “closed” on success.

Example call

{
  "tool": "close_card",
  "arguments": {
    "card_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