codespar_issue
Issue and control payment cards for AI agents or end-users. Virtual + physical cards, freeze/unfreeze/cancel. Routes to Pomelo (pan-LATAM issuing). Typed wrapper session.issue(args).
codespar_issue
Meta-tool
codespar_issue creates and controls payment cards — the agent-spend-card primitive. It creates spend instruments, distinct from codespar_pay / codespar_charge, which move money. Routes to Pomelo (pan-LATAM card issuing-as-a-service). Covered by the session.issue(args) typed wrapper.
Actions
action | Purpose |
|---|---|
card-virtual (default) | Issue a virtual card (active immediately) |
card-physical | Issue a physical card (needs shipping_address) |
card-control | Freeze / unfreeze / cancel an existing card |
card-get | Read a card's status |
Typed wrapper
// Issue a virtual card for an agent
const card = await session.issue({
action: "card-virtual",
cardholder_id: "<pomelo-user-id>",
program_id: "<pomelo-affinity-group>",
});
// Freeze it
await session.issue({
action: "card-control",
card_id: card.card_id,
control: "freeze",
reason: "suspicious activity",
});card = session.issue({
"action": "card-virtual",
"cardholder_id": "<pomelo-user-id>",
"program_id": "<pomelo-affinity-group>",
})Direct execute
const status = await session.execute("codespar_issue", {
action: "card-get",
card_id: "<card-id>",
});Args shape
| Field | Type | Required | Description |
|---|---|---|---|
action | "card-virtual" | "card-physical" | "card-control" | "card-get" | No | Defaults to "card-virtual" |
cardholder_id | string | issue | Pomelo user the card belongs to |
program_id | string | issue | Card program / BIN (Pomelo affinity group) |
card_id | string | control, get | Card id — required for card-control and card-get |
control | "freeze" | "unfreeze" | "cancel" | control | Control action |
reason | string | No | Reason stamped on a control action |
shipping_address | object | physical | Shipping address (card-physical only) |
metadata | object | No | Provider-specific overrides |
Operator setup
- Pomelo — API key (
api_keyauth_type). The operator connects the Pomelo account in/dashboard/auth-configs; the cardholder and program/BIN are provisioned in Pomelo and referenced by id.
See also
- codespar_pay — move money (cards are a spend instrument, not a transfer)
- Wallets — spending limits + policy on agent spend
- Tools & meta-tools — full meta-tool list
codespar_ledger
Double-entry ledger — record money movement, read balances, create accounts. Routes to the tenant's self-hosted Lerian Midaz. Typed wrapper session.ledger(args).
codespar_discover
Semantic + lexical tool search. pgvector text-embedding-3-small + pg_trgm fallback, with connection bias toward providers the session can already reach.