> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# close_card

> Permanently close a virtual 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

```json theme={null}
{
  "tool": "close_card",
  "arguments": {
    "card_id": "\u2026"
  }
}
```
