get_card_details

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

What it does

Get decrypted PAN, CVV, expiry, and current balance for a specific card. Use this only when you need to fill in a payment form — prefer get_card_balance if you only need the balance. May require human approval before returning credentials. If approval is required, prompt the user and then call approve_request. Card details are encrypted at rest with AES-256-GCM.

Inputs

Field	Type	Description
`card_id` (required)	string	The card ID
`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 card details (or an approval-required prompt).
`status`	string	Outcome discriminator: “details” when credentials were returned, “approval_required” when human approval is needed first, “not_accessible” when the card exists outside this connection’s scope, “policy_denied” when the card’s rules refuse the reveal, with the reason in the message, for example a CLI-only card read from MCP, “managed_by_organization” for org-issued read-only cards.
`cardId`	string	The card ID.
`expiry`	string	Card expiry (MM/YY). Present only when status is “details”.
`last4`	string	Last four digits of the card number. Present only when status is “details”.
`balanceCents`	number	Card balance in cents. Present only when status is “details”.
`balanceDollars`	string	Card balance formatted as USD dollars, e.g. “12.50”. Present only when status is “details”.
`cardStatus`	string	Card status, e.g. “active” or “closed”. Present only when status is “details”.
`approvalId`	string	The approval request ID to pass to approve_request. Present only when status is “approval_required”.

Example call

{
  "tool": "get_card_details",
  "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