Menu
ASG Card — virtual MasterCard cards for AI agents, powered by x402 on Stellar
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | asgcard |
| description | ASG Card — virtual MasterCard cards for AI agents, powered by x402 on Stellar |
CRITICAL: Always use
npx -y @asgcard/cli@latest(with@latesttag!) to ensure you are running the newest published version with all bug fixes.
NEVER use placeholder, test, or example data for email, phone, or name. You MUST ask the user for their real email address, phone number, and name before running any card creation or payment request command. If the user has previously provided their email/phone in the current conversation, you may reuse it. Otherwise, always ask first.
❌ WRONG:
-e "test@example.com" -p "+12345678900" -n "Test User"✅ RIGHT: Ask the user: "What email, phone number, and name should I use for the card?"
Run the full 9-step onboarding wizard:
npx -y @asgcard/cli@latest onboard -y
Steps: Agent Skill → MCP Config → Wallet → API Registration → Telegram Identity → Wallet Activation → Fund Link → Balance Check → Summary
asgcard onboard -y to set up wallet, MCP, and skillget_wallet_status MCP tool to verify wallet address and USDC balanceasgcard fund-link or MCP get_fund_link to generate a deposit URLget_pricing to see card and top-up pricingcreate_card with amount, name, email, and phone — all provided by the userlist_cards, get_card, get_card_details, freeze_card, unfreeze_cardfund_card to add funds to an existing cardget_transactions and get_balance to track activityUse this flow when the user wants to pay with a regular credit/debit card instead of USDC.
npx -y @asgcard/cli@latest stripe:session <USER_EMAIL>
The user's real email is required. This creates a session saved to ~/.asgcard/stripe-session.json.
npx -y @asgcard/cli@latest stripe:request \
-a <AMOUNT> \
-n "<USER_NAME>" \
-e "<USER_EMAIL>" \
-p "<USER_PHONE>" \
-d "<DESCRIPTION>"
All parameters are mandatory. You MUST collect the user's real name, email, and phone BEFORE running this command.
This returns:
pr_xxxxx)npx -y @asgcard/cli@latest stripe:wait <REQUEST_ID>
This polls until the owner completes Stripe payment and the card is issued.
If wallet has insufficient USDC:
asgcard fund-link or MCP get_fund_link| Command | Description |
|---|---|
asgcard onboard -y | Full 9-step onboarding |
asgcard status | Onboarding lifecycle status |
asgcard fund-link | Generate deposit URL |
asgcard wallet-balance | Show wallet USDC balance |
asgcard doctor | Diagnose setup issues (11 checks) |
asgcard wallet info | Show wallet address & balance |
asgcard cards | List all virtual cards |
asgcard card:create | Create a new virtual card |
asgcard card:fund <id> | Top up existing card |
asgcard card:details <id> | Get PAN, CVV, expiry |
asgcard card:freeze <id> | Freeze card |
asgcard card:unfreeze <id> | Unfreeze card |
asgcard transactions <id> | Card transaction history |
asgcard balance <id> | Live card balance |
asgcard history | All cards + balances |
asgcard pricing | Current pricing |
asgcard telegram:link | Generate TG deep-link |
asgcard telegram:status | Check TG connection |
asgcard telegram:revoke | Disconnect TG |
asgcard stripe:session | Create Stripe MPP session |
asgcard stripe:request | Create payment request |
asgcard stripe:wait <id> | Wait for payment completion |
| Tool | Description |
|---|---|
get_wallet_status | Check wallet address, USDC + XLM balances, and readiness |
get_pricing | View pricing (card $10, top-up 3.5%) |
create_card | Create virtual MasterCard (pays USDC on-chain via x402) |
fund_card | Top up existing card with USDC |
list_cards | List all wallet cards |
get_card | Get card summary |
get_card_details | Get PAN, CVV, expiry (sensitive, rate-limited 5/hr) |
freeze_card | Temporarily freeze card |
unfreeze_card | Re-enable frozen card |
get_transactions | Card transaction history |
get_balance | Live card balance |
| Tool | Description |
|---|---|
get_onboard_status | Onboarding lifecycle status |
connect_telegram | Register wallet and get TG deep-link for identity binding |
get_fund_link | Generate fund.asgcard.dev URL |
get_wallet_balance | Wallet USDC + XLM balances (Horizon-cached) |
| Tool | Description |
|---|---|
telegram_link | Generate one-time TG deep-link (10min expiry) |
telegram_status | Check if TG notifications are connected |
telegram_revoke | Disconnect TG notifications |
@asgcard/pay)For advanced agent-to-agent or multi-chain payment scenarios, the
@asgcard/paySDK provides a unified payment layer.
| Network | Protocol |
|---|---|
| Stellar | x402 (native) |
| Ethereum | EVM adapter |
| Base | EVM adapter |
| Arbitrum | EVM adapter |
| Optimism | EVM adapter |
| Polygon | EVM adapter |
| Solana | Solana adapter |
| Stripe | MPP / Fiat adapter |
| Any OWS wallet | Open Wallet Standard adapter |
@open-wallet-standard/corenpm install @asgcard/pay
import { PayClient, StellarAdapter, EvmAdapter, OWSAdapter } from '@asgcard/pay';
const client = new PayClient({
adapters: [new StellarAdapter(), new EvmAdapter(), new OWSAdapter()],
});
Example: create a $50 card → you pay $50 + $10 + 3.5% = $62.10 USDC.
When the user wants to receive transaction notifications (charges, declines, refunds, top-ups) via Telegram:
npx -y @asgcard/cli@latest telegram:link
Or use MCP tool telegram_link. Link expires in 10 minutes.
Show the deep-link to the user and tell them: "Click this link in Telegram to connect notifications for your wallet."
npx -y @asgcard/cli@latest telegram:status
Or use MCP tool telegram_status.
npx -y @asgcard/cli@latest telegram:revoke
Or use MCP tool telegram_revoke.
@asgcard/pay SDK (EVM, Solana, OWS)~/.asgcard/wallet.json@latest tag with npx to avoid stale cached versions