Quick Start · Docs · Website · Twitter · Security

---

Public mirror — this repo is a read-only mirror of the internal monorepo. For issues and feature requests use GitHub Issues. For code contributions see CONTRIBUTING.md.

Agent Card

Agent Card is an agent-first virtual card platform. AI agents programmatically issue and manage MasterCard virtual cards, paying in USDC via the x402 protocol on Stellar.

Works with

Codex

Claude Code

Cursor

OpenClaw

Any MCP

Built with

Stellar

Circle USDC

MasterCard

If it speaks MCP, it can spend.

🎬 Demo

📹 Watch the full product video

Agent Card is right for you if

• ✅ Your AI agent needs to pay for things — hosting, domains, APIs, SaaS
• ✅ You want a virtual MasterCard issued programmatically
• ✅ You want your agent to manage cards autonomously via MCP
• ✅ You want to pay in USDC without touching fiat banking
• ✅ You need transparent, on-chain proof of every payment

Quick Start

For Codex

npx @asgcard/cli onboard -y --client codex

For Claude Code

npx @asgcard/cli onboard -y --client claude

For Cursor

npx @asgcard/cli onboard -y --client cursor

Using the SDK directly

npm install @asgcard/sdk

Via ClawHub

npx clawhub@latest install agentcard

The onboarding flow creates a Stellar wallet (~/.asgcard/wallet.json), configures MCP, installs the agent skill, and prints the next step.

Note: If you already have a wallet, run npx @asgcard/cli doctor to verify your setup.

How It Works

1. Agent requests a card → API returns 402 Payment Required with USDC amount
2. Agent signs a Stellar USDC transfer via the SDK
3. x402 Facilitator verifies and settles the payment on-chain
4. API issues a real MasterCard via the card issuer
5. Card details returned in the response

Live pricing: GET https://api.asgcard.dev/pricing · Full docs: asgcard.dev/docs

MCP Server (11 tools)

@asgcard/mcp-server exposes 11 tools via the Model Context Protocol. The MCP server reads your Stellar key from ~/.asgcard/wallet.json — no env vars needed in client configs.

Tool	What it does
get_wallet_status	Wallet address, USDC balance, readiness
create_card	Create virtual MasterCard (x402 payment)
fund_card	Top up existing card
list_cards	List all wallet cards
get_card	Card summary
get_card_details	PAN, CVV, expiry (nonce-protected)
freeze_card / unfreeze_card	Freeze or re-enable a card
get_pricing	Current pricing ($10 card + 3.5% top-up)
get_transactions	Card transaction history (real issuer data)
get_balance	Live card balance from card issuer

SDK

import { ASGCardClient } from "@asgcard/sdk";

const client = new ASGCardClient({
  privateKey: "S...",  // Stellar secret key
  rpcUrl: "https://mainnet.sorobanrpc.com"
});

const card = await client.createCard({
  amount: 10,
  nameOnCard: "AI Agent",
  email: "agent@example.com"
});

// List cards, check balance, view transactions
const { cards } = await client.listCards();
const balance = await client.getBalance(cards[0].cardId);
const txns = await client.getTransactions(cards[0].cardId);

See /sdk for full API reference.

CLI Commands

npx @asgcard/cli transactions <cardId>   # View card transaction history
npx @asgcard/cli balance <cardId>         # Get live card balance
npx @asgcard/cli history                  # All cards with live balances
npx @asgcard/cli cards                    # List all your cards
npx @asgcard/cli pricing                  # View pricing tiers

Repository Structure

This is a monorepo. Most users should use npx @asgcard/cli or npm install @asgcard/sdk — cloning is only needed for contributing.

Directory	Package
/api	ASG Card API (Express + x402 + wallet auth)
/sdk	@asgcard/sdk — TypeScript client
/cli	@asgcard/cli — CLI + onboarding
/mcp-server	@asgcard/mcp-server — MCP server (11 tools)
/web	Marketing website (asgcard.dev)
/docs	Documentation and ADRs

Security

• 🔒 AES-256-GCM encryption at rest for card details
• 🔑 Stellar private key never leaves your machine (~/.asgcard/wallet.json)
• 🛡️ Nonce-based anti-replay protection
• ✅ Wallet signature authentication — no API keys
• 📋 Security Policy · Technical Overview

Community

• GitHub Issues — bugs and feature requests
• asgcard.dev — docs and website
• Twitter/X — updates

License

MIT © 2025 ASG Compute