ASG Cardは、エージェントファーストなバーチャルカードプラットフォームです。AIエージェントがプログラムからMasterCardのバーチャルカードを発行・管理し、Stellar x402 (USDC) または Stripe Machine Payments Protocol (カード) を介して支払うことができます。

クイックスタート — 最初のカード

# One-step onboarding (creates wallet, configures MCP, installs skill)
npx @asgcard/cli onboard -y --client codex

# Fund your wallet with USDC on Stellar (address shown by onboard)
# Then:
npx @asgcard/cli card:create -a 10 -n "AI Agent" -e you@email.com

SDKの使用方法

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

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

// Automatically handles: 402 → USDC payment → card creation
const card = await client.createCard({
  amount: 10,        // $10 card load
  nameOnCard: "AI Agent",
  email: "agent@example.com"
});

// card.detailsEnvelope = { cardNumber, cvv, expiryMonth, expiryYear }

SDKメソッド

メソッド	説明
`createCard({amount, nameOnCard, email, phone?})`	x402決済でバーチャルカードを発行
`fundCard({amount, cardId})`	既存のカードにチャージ
`listCards()`	ウォレット内の全カードを一覧表示
`getTransactions(cardId, page?, limit?)`	カードの取引履歴を取得
`getBalance(cardId)`	カードの現在の残高を取得
`getPricing()`	現在の料金体系を取得
`health()`	APIのヘルスチェック

MCPサーバー (AIエージェント統合)

@asgcard/mcp-server は、Codex、Claude Code、Cursor向けに11個のツールを提供します：

ツール	説明
`get_wallet_status`	最初に使用 — ウォレットアドレス、USDC残高、準備状況
`create_card`	バーチャルカードを作成 (x402決済)
`fund_card`	既存のカードにチャージ (x402決済)
`list_cards`	ウォレット内の全カードを一覧表示
`get_card`	カードの概要を取得
`get_card_details`	PAN、CVV、有効期限を取得
`freeze_card`	カードを凍結
`unfreeze_card`	カードの凍結を解除
`get_pricing`	料金体系を表示
`get_transactions`	カードの取引履歴 (4paymentsのリアルデータ)
`get_balance`	4paymentsからのカード残高リアルタイム取得

MCPのセットアップ

npx @asgcard/cli install --client codex    # or claude, cursor

アーキテクチャ

graph TB
    subgraph Clients
        SDK["@asgcard/sdk<br>(npm, TypeScript)"]
        CLI["@asgcard/cli<br>onboard + card ops"]
        MCP["@asgcard/mcp-server<br>11 tools"]
        TG["Telegram Bot<br>@ASGCardbot"]
        WEB["asgcard.dev"]
        STRIPE_WEB["stripe.asgcard.dev"]
    end

    subgraph ASG Infrastructure
        API["ASG Card API<br>api.asgcard.dev"]
        FAC["x402 Facilitator"]
        DB["PostgreSQL"]
    end

    subgraph Payment Rails
        STELLAR["Stellar Pubnet<br>USDC"]
        STRIPE["Stripe<br>MPP"]
    end

    subgraph External
        ISSUER["Card Issuer<br>(MasterCard)"]
    end

    SDK -->|"x402 HTTP"| API
    CLI -->|"x402 HTTP"| API
    MCP -->|"x402 HTTP"| API
    TG -->|"Webhook"| API
    WEB -->|"Pricing"| API
    STRIPE_WEB -->|"MPP"| API
    API -->|"verify/settle"| FAC
    API -->|"SQL"| DB
    API -->|"REST"| ISSUER
    FAC -->|"Soroban RPC"| STELLAR
    API -->|"PaymentIntent"| STRIPE
    SDK -->|"Sign TX"| STELLAR

決済レール

ASG Cardは2つの決済レールをサポートしています。カード製品自体は同一ですが、支払い方法が異なります。

Stellarエディション (x402)

エージェントがカードをリクエスト → APIがUSDC金額と共に 402 Payment Required を返却
エージェントがSDK経由でStellar USDC送金に署名
x402ファシリテーターがオンチェーンで支払いを検証・決済
APIがカード発行会社を通じてMasterCardを発行
カード詳細がレスポンスとして即座に返却

用途: SDK、CLI、MCPサーバー。人間が介在しません。

Stripeエディション (MPP)

エージェントが支払いリクエストを作成 → APIが approval_required と approvalUrl を返却
オーナーが stripe.asgcard.dev/approve で承認ページを開く
オーナーが確認・承認 → リアルタイム価格設定付きのStripe Elementsフォーム
オーナーがStripeで支払い → カード/Apple Pay/Google Pay
カード作成 → エージェントが completed になるまでポーリング

用途: セッションベースの認証 (X-STRIPE-SESSION)。人間による承認が必要。

ワークスペース

ディレクトリ	説明
`/api`	ASG Card API (Express + x402 + Stripe MPP)
`/sdk`	`@asgcard/sdk` TypeScriptクライアント
`/cli`	`@asgcard/cli` オンボーディング付きCLI
`/mcp-server`	`@asgcard/mcp-server` MCPサーバー (11ツール)
`/web`	マーケティングサイト (asgcard.dev)
`/web-stripe`	Stripeエディションサイト (stripe.asgcard.dev)
`/docs`	内部ドキュメントおよびADR

APIエンドポイント

パブリック

ルート	メソッド	説明
`/health`	GET	ヘルスチェック
`/pricing`	GET	料金情報
`/cards/tiers`	GET	料金情報
`/supported`	GET	x402の機能

Stellar x402 (支払いが必要)

ルート	メソッド	説明
`/cards/create/tier/:amount`	POST	バーチャルカードを作成
`/cards/fund/tier/:amount`	POST	既存のカードにチャージ

ウォレット認証済み

ルート	メソッド	説明
`/cards/`	GET	ウォレットのカード一覧
`/cards/:id`	GET	カード詳細
`/cards/:id/details`	GET	機密データ (nonceが必要)
`/cards/:id/transactions`	GET	カードの取引履歴
`/cards/:id/balance`	GET	カードのリアルタイム残高
`/cards/:id/freeze`	POST	カードを凍結
`/cards/:id/unfreeze`	POST	カードの凍結を解除

Stripe MPP (ベータ版)

ルート	メソッド	説明
`/stripe-beta/session`	POST	管理セッションを作成
`/stripe-beta/payment-requests`	POST	支払いリクエストを作成
`/stripe-beta/payment-requests/:id`	GET	リクエストステータスのポーリング
`/stripe-beta/approve/:id`	GET/POST	承認ページデータ / 承認または拒否
`/stripe-beta/approve/:id/complete`	POST	支払いを完了 (MPP認証情報)
`/stripe-beta/cards`	GET	セッションのカード一覧
`/stripe-beta/cards/:id/details`	GET	カード詳細 (nonceが必要)

料金

シンプルで透明性が高く、隠れた手数料はありません。

カード作成一律 $10 (初期チャージ不要)
チャージごとに 3.5%

以上です。$5から$5,000まで、任意の金額をチャージできます。

チャージなしでカード作成 → $10。$100チャージしてカード作成 → $113.50。後から$200チャージ → $207。 StellarとStripeの両レールで同一料金です。

Telegramボット (@ASGCardbot)

ウォレットをTelegramにリンクしてカードを管理しましょう：

コマンド	説明
`/start`	ウェルカム / アカウントリンク
`/mycards`	カード一覧
`/faq`	よくある質問
`/support`	サポート

セキュリティ

カード詳細は AES-256-GCM で暗号化して保存
エージェントのnonceベースの再生攻撃防止 (1時間あたり5回読み取り)
ウォレット署名認証 (Stellarエディション)
ベータゲート付きセッションベース認証 (Stripeエディション)
Stripeセッションキーはログから削除
Telegram Webhookのシークレット検証
OpsエンドポイントはAPIキーとIP許可リストで保護

コントリビューション

コントリビューションを歓迎します！ガイドラインについては CONTRIBUTING.md を参照し、good first issue ラベルの付いたIssueを確認してください。

当プロジェクトは行動規範に従います。

ライセンス

MIT

ASG Card