> ## 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.

# create_card

> Create a new virtual debit card funded by your saved payment method

Creates a live virtual debit card. The card is funded by the saved payment method and charged for real when used, so call `setup_payment_method` first if none is saved, and check `get_plan` for your per-card cap and monthly quota.

<Note>
  If your app connected with a **sandbox** OAuth client, this mints a **test card** instead — mock funds, no real charge, not usable at real merchants — for integration testing. A **production** client (which requires an active subscription) mints live cards. See [Production](/companies/production).
</Note>

## Parameters

| Parameter      | Type   | Required | Description                                                                                                                               |
| -------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `amount_cents` | number | Yes      | Card funding amount in cents (minimum 100). The maximum depends on your plan: $50.00 on Free, $500.00 on Basic. Call `get_plan` to check. |

## Returns

On success, `status` is `created` with the new card's ID, last four digits, expiry, balance, and a billing address to use for online purchases. Your payment method is only charged when the card is used, and the card expires if not used within 7 days. The call can also pause with `approval_required` and an `approvalId`, which you resolve with [approve\_request](/companies/mcp/tools/approve_request) after asking the user. Other statuses tell you what to fix first, such as `payment_method_required`, `kyc_required`, `user_info_required`, or `limit_reached`.

## Example

```json theme={null}
{ "name": "create_card", "arguments": { "amount_cents": 2500 } }
```