grandamenium AgentCard Purchase
Issue a scoped, single-use virtual Visa card to complete a purchase. Cards are funded on demand, capped at the approved amount, and auto-close after one transaction.
Requires: AgentCard MCP server configured via agent-cards setup-mcp (CLI: npm i -g agentcard).
When to Use
You need to spend real money on behalf of the user. Examples:
- Buy a domain name
- Subscribe to a paid API or SaaS tool
- Purchase credits (OpenAI, cloud compute, etc.)
- Pay an invoice that was sent to the org
Workflow
Step 1: Request approval (uses the approvals skill)
Never create a card before getting approval. Use the financial category.
APPR_ID=$(cortextos bus create-approval \
"Purchase: $VENDOR — $AMOUNT for $REASON" \
"financial" \
"Vendor: $VENDOR | Amount: \$$AMOUNT | Justification: $REASON")
echo "APPR_ID=$APPR_ID"
cortextos bus update-task "$TASK_ID" blocked
cortextos bus send-telegram "$CTX_TELEGRAM_CHAT_ID" \
"Purchase approval needed: \$$AMOUNT for $VENDOR — $REASON"
Wait for approval via inbox. Do not proceed until you receive decision: approved.
Step 2: Create the virtual card
After approval, issue a card scoped to the purchase amount. Amount is in cents.
Use the AgentCard MCP tools:
mcp__agent-cards__create_card(amount_cents: NUMBER, sandbox: false)
Example for a $15 purchase:
mcp__agent-cards__create_card(amount_cents: 1500)
The tool returns: card ID, last4, expiry, balance, and billing address.
Step 3: Get card details for checkout
mcp__agent-cards__get_card_details(card_id: "CARD_ID")
Returns full PAN, CVV, expiry month/year, and billing address. Use these to fill checkout forms.
Step 4: Complete the purchase
Use the card details to complete checkout. For web purchases, use browser automation or fill forms via API. The billing address is:
2261 Market Street #4242
San Francisco, CA 94114, US
Step 5: Verify and close
Check that the transaction went through:
mcp__agent-cards__list_transactions(card_id: "CARD_ID")
Cards auto-close after one transaction. If the purchase failed or you no longer need the card:
mcp__agent-cards__close_card(card_id: "CARD_ID")
Step 6: Log the result
cortextos bus complete-task "$TASK_ID" --result "Purchased $VENDOR for \$$AMOUNT. Card ****$LAST4. Transaction: $STATUS"
cortextos bus log-event task purchase_completed info --meta "{\"vendor\":\"$VENDOR\",\"amount_cents\":$AMOUNT_CENTS,\"card_last4\":\"$LAST4\"}"
Limits (Free Tier)
| Limit | Value |
|---|---|
| Cards per month | 5 |
| Max per card | $50 |
| Card lifetime | 7 days (unused) |
| Transactions per card | 1 (single-use) |
Upgrade to Basic ($15/mo) for 15 cards/month and $500 max per card: agent-cards plan upgrade.
Available MCP Tools
| Tool | Purpose |
|---|---|
create_card |
Issue a new virtual card (amount_cents, sandbox) |
list_cards |
List all cards with status |
get_card_details |
Get PAN, CVV, expiry for checkout |
check_balance |
Check remaining balance (no sensitive data) |
close_card |
Permanently close a card |
list_transactions |
View transactions for a card |
Critical Rules
- Approval first, always. Never create a card without an approved
financialapproval. - Scope the amount. Create the card for the exact purchase amount, not more. If a $12 domain, create a $12 card (1200 cents).
- One card per purchase. Do not reuse cards across transactions.
- Close unused cards. If the purchase fails or is cancelled, close the card immediately.
- Never log full PAN/CVV. Only reference cards by last4 in task results and events.
- Sandbox for testing. Use
sandbox: truewhen testing the flow without real charges.