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.

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

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.

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