create_card

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

What it does

Issue a virtual card for a cardholder, holding an exact amount in cents (2500 = $25.00). Default is one-time-use: the first approved charge spends it and the card closes itself. Pass type “multi_use” for a reusable card that survives repeated charges until its balance is spent (or expires_at passes). In sandbox this issues a test card (mock, never charged). If the cardholder is not ready, the error says exactly which gate to clear: kyc_required (run start_cardholder_kyc), insufficient_balance or deposit_confirming (the user’s balance), payment_method_required, or org_funding_required (your company balance, with funds_source “company_flow”).

Inputs

Field	Type	Description
`cardholder_id` (required)	string	Which cardholder the card is for
`amount_cents` (required)	number	Exact amount in cents, minimum 100 ($1.00)
`funds_source`	string: `onramp_flow` · `company_flow`	onramp_flow (default): the user’s own balance pays. company_flow: your pooled company balance pays.
`type`	string: `single_use` · `multi_use`	single_use (default): closes after the first approved charge. multi_use: reusable until the balance is spent.
`expires_at`	string	Multi-use only: ISO-8601 expiry in the future, at most 365 days out. The card closes then and any unused balance is released.
`idempotency_key`	string	Stable key for THIS card intent (e.g. your order id). Always pass one with company_flow: retries then attach to the in-flight funding instead of double-funding, and a funding_in_progress retry must reuse the same key.

Returns

Field	Type	Description
`message` (required)	string	Human-readable outcome.
`status`	string	”created”, “funding_in_progress”, or a readiness gate: kyc_required \| insufficient_balance \| deposit_confirming \| payment_method_required \| org_funding_required.
`cardId`	string	Present when created.
`last4`	string	Present when created.
`verificationUrl`	string	Present on kyc_required when a verification link exists.
`retryAfterSeconds`	number	Present on funding_in_progress / deposit_confirming — retry after this many seconds.

Example call

{
  "tool": "create_card",
  "arguments": {
    "cardholder_id": "\u2026",
    "amount_cents": "\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