agentcard-purchase

name	agentcard-purchase
description	You need to make a purchase on behalf of the user — buy a SaaS subscription, pay for an API, purchase a domain, or any transaction requiring a credit card. Use this skill to request approval, issue a scoped virtual Visa card via AgentCard, and complete the purchase autonomously. Requires the AgentCard MCP server to be configured.
triggers	["buy","purchase","pay for","subscribe to","need a credit card","make a payment","sign up for paid plan","buy a domain","purchase API credits","pay invoice","need to pay","financial transaction","virtual card","agentcard"]
external_calls	["mcp.agentcard.sh","api.agentcard.sh"]

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

1. Approval first, always. Never create a card without an approved financial approval.
2. Scope the amount. Create the card for the exact purchase amount, not more. If a $12 domain, create a $12 card (1200 cents).
3. One card per purchase. Do not reuse cards across transactions.
4. Close unused cards. If the purchase fails or is cancelled, close the card immediately.
5. Never log full PAN/CVV. Only reference cards by last4 in task results and events.
6. Sandbox for testing. Use sandbox: true when testing the flow without real charges.