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

Agent Card CLI 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

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

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

MCP Server (9 tools)

@asgcard/mcp-server exposes 9 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 tier pricing

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"
});

See /sdk for full API reference.

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 (9 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

ASG Card