get_card — Retrieve a single card

The get_card tool returns a single card by cardId within an organization, including spending limits, expiration, and status. Use it when your agent already knows the card ID and needs full details. intent, organizationId, and cardId are required, and the token must carry the cards.read scope.

Scope

Required OAuth scope: cards.read

Input

string

required

The organization that owns the card. Must be one of the organizations the token can access.

string

required

The unique card identifier to retrieve.

string

required

What the user asked for and why this call serves it, in 1 to 500 characters. Required on every tool call. See Common tool arguments.

Output

Card

required

The requested card object.

Show Card

string

required

Always "card".

string

required

Unique card identifier.

string

required

Organization the card belongs to.

string

required

Account the card is linked to.

string

Last four digits of the card number. May be absent. The full card number is never returned.

string

required

Display nickname of the card.

string

required

Card form factor. Values: physical, virtual.

string

required

Card category. Values: debit, credit.

string

required

Card status. Values: pending, active, inactive, terminated, locked, unlockInProgress. Terminated cards are listed like any other.

string

required

Name of the cardholder.

integer

required

Expiration month (1-12).

integer

required

Expiration year.

object

required

Spending limits as Money objects. Individual values may be null when no limit is set.

Show SpendingLimits

Money | null

Daily purchase limit.

Money | null

Daily ATM withdrawal limit.

Money | null

Monthly purchase limit.

string

required

Timestamp when the card was created, in RFC 3339 format.

Example

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "get_card",
    "arguments": {
      "intent": "User asked for the spending limits on their marketing card.",
      "organizationId": "org_1",
      "cardId": "card_1"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 7,
  "result": {
    "structuredContent": {
      "data": {
        "object": "card",
        "id": "card_1",
        "organizationId": "org_1",
        "accountId": "acc_1",
        "last4": "4242",
        "nickname": "Marketing card",
        "type": "virtual",
        "category": "debit",
        "status": "active",
        "cardholderName": "Jane Doe",
        "expMonth": 11,
        "expYear": 2028,
        "spendingLimits": {
          "dailyPurchase": { "cents": 500000, "display": "5,000.00", "currency": "USD" },
          "dailyAtmWithdrawal": { "cents": 100000, "display": "1,000.00", "currency": "USD" },
          "monthlyPurchase": { "cents": 5000000, "display": "50,000.00", "currency": "USD" }
        },
        "createdAt": "2026-01-04T00:00:00.000Z"
      }
    }
  }
}

Notes

The last4 field may be absent. The full card number is never returned.
Terminated cards are returned like any other.
spendingLimits values are Money objects and may be null.
If the card does not exist or is not accessible with the provided token, the tool returns an MCP error: Card not found or not accessible.

list_cards

List all cards for an organization with pagination.

Errors

Learn how MCP tool errors and HTTP auth failures are surfaced.

Organizations

Transactions

Accounts

Cards

Statements

Contacts

Catalog items

Invoices

get_card — Retrieve a single card

Scope

Input

Output

Example

Notes

list_cards

Errors

​Scope

​Input

​Output

​Example

​Notes

list_cards

Errors

Scope

Input

Output

Example

Notes