asgcard

Category: Tools & Productivity | Uploader: ASGCompute | Downloads: 0 | Version: v1.0（Latest）

Virtual MasterCards for AI agents — create, fund, and manage payment cards autonomously using USDC on Stellar via the x402 protocol.

Changelog: Source: GitHub https://github.com/ASGCompute/asgcard-public

Directory Structure

Current level: Root

📁 .github/
- 📁 assets/
  - 📁 logos/
    
    📄 circle.svg 1.8 KB
    
    📄 claude.svg 296 B
    
    📄 codex.svg 1.3 KB
    
    📄 cursor.svg 469 B
    
    📄 mastercard.svg 430 B
    
    📄 mcp.svg 365 B
    
    📄 openclaw.svg 1.2 KB
    
    📄 sdk.svg 265 B
    
    📄 stellar.svg 1.0 KB
  - 📄 demo.gif 443.0 KB
  - 📄 demo.mp4 4.0 MB
  - 📄 works-with.png 344.5 KB
- 📁 ISSUE_TEMPLATE/
  - 📄 bug_report.yml 1.5 KB
  - 📄 feature_request.yml 1.4 KB
  - 📄 incident_report.yml 1.8 KB
  - 📄 security_report.yml 1.2 KB
- 📁 workflows/
  - 📄 gitleaks.yml 1.7 KB
  - 📄 guardrail.yml 3.7 KB
- 📄 CODEOWNERS 14 B
- 📄 FUNDING.yml 21 B
📁 api/
- 📁 __tests__/
  - 📄 persistence.test.ts 11.0 KB
  - 📄 setup.ts 108 B
  - 📄 webhook-and-verify.test.ts 5.7 KB
  - 📄 x402-challenge.test.ts 6.4 KB
- 📁 scripts/
  - 📄 e2e-mainnet.js 8.8 KB
  - 📄 preflight.js 9.2 KB
- 📁 src/
  - 📁 config/
    
    📄 env.ts 5.6 KB
    
    📄 pricing.ts 2.4 KB
  - 📁 db/
    
    📁 migrations/
    
    📄 001_create_tables.sql 3.1 KB
    
    📄 002_api_metrics.sql 643 B
    
    📄 003_bot_tables.sql 3.8 KB
    
    📄 004_agent_access.sql 978 B
    
    📄 005_nonce_retention.sql 1.2 KB
    
    📄 006_card_reveal_tokens.sql 1.9 KB
    
    📄 007_api_activity.sql 1.1 KB
    
    📄 008_last_four.sql 283 B
    
    📄 009_profile_fields.sql 193 B
    
    📄 db.ts 1.7 KB
  - 📁 middleware/
    
    📄 agentDetailsMiddleware.ts 2.6 KB
    
    📄 walletAuth.ts 3.1 KB
    
    📄 x402.ts 6.9 KB
  - 📁 modules/
    
    📁 admin/
    
    📄 adminBot.ts 8.4 KB
    
    📄 index.ts 253 B
    
    📄 statusCollector.ts 11.0 KB
    
    📄 webhook.ts 8.2 KB
    
    📁 authz/
    
    📄 auditService.ts 2.9 KB
    
    📄 index.ts 239 B
    
    📄 ownerPolicy.ts 2.3 KB
    
    📁 bot/
    
    📁 commands/
    
    📄 faq.ts 529 B
    
    📄 fund.ts 7.7 KB
    
    📄 myCards.ts 13.4 KB
    
    📄 profile.ts 6.3 KB
    
    📄 start.ts 2.0 KB
    
    📄 support.ts 548 B
    
    📁 services/
    
    📄 alertService.ts 7.1 KB
    
    📄 metricsService.ts 6.2 KB
    
    📄 statementService.ts 6.1 KB
    
    📄 index.ts 333 B
    
    📄 keyboards.ts 2.4 KB
    
    📄 telegramClient.ts 5.2 KB
    
    📄 templates.ts 8.0 KB
    
    📄 webhook.ts 13.1 KB
    
    📁 notify/
    
    📄 eventRouter.ts 1.7 KB
    
    📄 index.ts 241 B
    
    📄 notifyService.ts 5.8 KB
    
    📁 portal/
    
    📄 agentAccess.ts 1.8 KB
    
    📄 index.ts 301 B
    
    📄 linkService.ts 7.1 KB
    
    📄 routes.ts 2.7 KB
  - 📁 repositories/
    
    📄 inMemoryCardRepo.ts 3.0 KB
    
    📄 inMemoryPaymentRepo.ts 1.6 KB
    
    📄 pgCardRepo.ts 8.4 KB
    
    📄 pgPaymentRepo.ts 4.2 KB
    
    📄 pgWebhookEventRepo.ts 2.7 KB
    
    📄 runtime.ts 2.8 KB
    
    📄 types.ts 2.6 KB
  - 📁 routes/
    
    📄 ops.ts 11.5 KB
    
    📄 paid.ts 2.9 KB
    
    📄 public.ts 2.4 KB
    
    📄 wallet.ts 2.7 KB
    
    📄 webhook.ts 4.8 KB
  - 📁 services/
    
    📄 cardService.ts 12.0 KB
    
    📄 facilitatorClient.ts 6.7 KB
    
    📄 fourPaymentsClient.ts 9.0 KB
    
    📄 metrics.ts 2.5 KB
    
    📄 paymentService.ts 4.6 KB
  - 📁 types/
    
    📄 domain.ts 962 B
    
    📄 express.d.ts 233 B
    
    📄 http-context.ts 266 B
    
    📄 x402.ts 2.5 KB
  - 📁 utils/
    
    📄 crypto.ts 2.5 KB
    
    📄 html.ts 485 B
    
    📄 logger.ts 2.3 KB
    
    📄 payment.ts 707 B
  - 📄 app.ts 2.0 KB
  - 📄 index.ts 310 B
  - 📄 vercel.ts 82 B
- 📄 .env.example 1.4 KB
- 📄 .gitignore 8 B
- 📄 package.json 1.0 KB
- 📄 tsconfig.json 468 B
- 📄 vercel.json 191 B
- 📄 vitest.config.ts 279 B
📁 cli/
- 📁 src/
  - 📄 index.ts 15.6 KB
  - 📄 wallet-client.ts 4.5 KB
- 📄 package-lock.json 53.5 KB
- 📄 package.json 1.1 KB
- 📄 README.md 2.2 KB
- 📄 tsconfig.json 445 B
📁 docs/
- 📁 adr/
  - 📄 ADR-001-service-boundaries.md 4.1 KB
  - 📄 ADR-002-x402-verify-settle-stellar.md 4.7 KB
  - 📄 ADR-003-smart-wallet-fit.md 5.4 KB
📁 mcp-server/
- 📁 src/
  - 📄 index.ts 1.1 KB
  - 📄 server.ts 10.3 KB
  - 📄 wallet-client.ts 4.5 KB
- 📄 package-lock.json 77.9 KB
- 📄 package.json 1.2 KB
- 📄 README.md 2.5 KB
- 📄 tsconfig.json 473 B
📁 sdk/
- 📁 src/
  - 📁 errors/
    
    📄 index.ts 843 B
  - 📁 types/
    
    📄 index.ts 3.9 KB
  - 📁 utils/
    
    📄 x402.ts 9.8 KB
  - 📄 client.ts 4.6 KB
  - 📄 index.ts 577 B
- 📄 package.json 923 B
- 📄 README.md 2.5 KB
- 📄 tsconfig.json 147 B
📁 web/
- 📁 docs/
  - 📄 index.html 4.3 KB
- 📁 public/
  - 📄 404.html 4.5 KB
  - 📄 agent.txt 1.7 KB
  - 📄 algorand-logo.svg 440 B
  - 📄 apple-touch-icon.png 305.3 KB
  - 📄 arbitrum-logo.svg 1.9 KB
  - 📄 coinbase-logo.svg 775 B
  - 📄 docs.md 5.1 KB
  - 📄 llms.txt 892 B
  - 📄 logo-lockup-light.svg 472 B
  - 📄 logo-lockup.svg 448 B
  - 📄 logo-mark-dark.svg 237 B
  - 📄 logo-mark-light.svg 237 B
  - 📄 logo-mark.svg 237 B
  - 📄 logo-wordmark.svg 246 B
  - 📄 og-builder.html 13.7 KB
  - 📄 og-card-onchain-v1-raw.png 512.3 KB
  - 📄 og-card-onchain-v1.png 447.3 KB
  - 📄 og-card-stellar-v3.png 78.9 KB
  - 📄 og-card-stellar-v4.png 490.5 KB
  - 📄 og-card-v2.png 87.4 KB
  - 📄 og-card.png 69.6 KB
  - 📄 og-docs.png 34.4 KB
  - 📄 openapi.json 22.8 KB
  - 📄 payai-logo.svg 4.6 KB
  - 📄 robots.txt 66 B
  - 📄 sitemap.xml 1.5 KB
  - 📄 stellar-logo-lockup.svg 3.2 KB
  - 📄 stellar-logo-mark.svg 3.2 KB
- 📁 src/
  - 📁 algorand/
    
    📄 proposal.ts 9.6 KB
  - 📁 arbitrum/
    
    📄 proposal.ts 9.6 KB
  - 📁 coinbase/
    
    📄 proposal.ts 9.8 KB
  - 📁 cypher/
    
    📄 proposal.ts 9.0 KB
  - 📁 lib/
    
    📄 pricing.ts 4.7 KB
  - 📁 paypal/
    
    📄 proposal.ts 9.5 KB
  - 📁 portal/
    
    📄 portal.ts 15.2 KB
  - 📁 wirex/
    
    📄 proposal.ts 9.0 KB
  - 📄 docs.css 16.0 KB
  - 📄 docs.ts 72.2 KB
  - 📄 main.ts 45.4 KB
  - 📄 proposal.ts 9.7 KB
  - 📄 style.css 39.4 KB
  - 📄 vite-env.d.ts 38 B
- 📄 .env.example 199 B
- 📄 .gitignore 8 B
- 📄 index.html 4.4 KB
- 📄 package.json 466 B
- 📄 postcss.config.js 92 B
- 📄 tailwind.config.js 1.0 KB
- 📄 tsconfig.json 654 B
- 📄 vercel.json 238 B
- 📄 vite.config.ts 584 B
📄 .gitignore 182 B
📄 CONTRIBUTING.md 2.1 KB
📄 LICENSE 1.0 KB
📄 package-lock.json 193.4 KB
📄 package.json 378 B
📄 PUBLIC_REPO_MANIFEST.md 1.8 KB
📄 README.md 6.5 KB
📄 SECURITY.md 1.1 KB
📄 SKILL.md 2.0 KB
📄 TECHNICAL_OVERVIEW.md 1.2 KB
📄 tsconfig.base.json 312 B

SKILL.md

---
name: asgcard
description: Virtual MasterCards for AI agents — create, fund, and manage payment cards autonomously using USDC on Stellar via the x402 protocol.
version: 1.0.8
emoji: 💳
homepage: https://asgcard.dev
metadata:
  openclaw:
    requires:
      env:
        - ASG_CARD_WALLET_SECRET
      bins: []
    primaryEnv: ASG_CARD_WALLET_SECRET
    os: ["macos", "linux", "windows"]
---

# Agent Card — Payment Skill

Give your AI agent a virtual MasterCard. Agent Card lets agents autonomously create, fund, and manage virtual MasterCard cards by paying in USDC on the Stellar blockchain.

## What It Does

- **Create cards** — Issue virtual MasterCards with per-card spend limits
- **Fund cards** — Top up existing cards with USDC
- **Manage cards** — List, freeze, unfreeze, and inspect card details
- **On-chain payments** — Every transaction uses the x402 protocol on Stellar with verifiable on-chain proof

## Setup

```bash
npx @asgcard/cli onboard -y
```

This creates a Stellar wallet (`~/.asgcard/wallet.json`), configures the MCP server, and installs the payment skill. Your agent is ready to pay in under 30 seconds.

## MCP Tools (9 available)

| Tool | Description |
|------|-------------|
| `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` | Freeze a card |
| `unfreeze_card` | Re-enable a card |
| `get_pricing` | Current tier pricing |

## Use Cases

- Pay for API credits (Anthropic, OpenAI, Google Cloud)
- Provision cloud infrastructure (DigitalOcean, Vercel)
- Buy domains, SaaS subscriptions, and developer tools
- Any merchant that accepts MasterCard

## Links

- [Documentation](https://asgcard.dev/docs)
- [npm SDK](https://npmjs.com/package/@asgcard/sdk)
- [GitHub](https://github.com/ASGCompute/asgcard-public)

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

asgcard

Directory Structure

SKILL.md

Report

Notice