AgentCard

@agent-cards/mcp

AI エージェントにデビットカードを持たせましょう。AgentCard を使うと、AI エージェントは仮想デビットカードを作成して利用できます。各カードには固定の予算、実際のカード情報、完全な MCP 統合が備わっています。エージェントは個人のカードを使うことなく、カードの作成、支払い、残高の確認、チェックアウトフォームへの自動入力を行えます。

クイックセットアップ

エージェントを接続する最も簡単な方法は、CLI を使うことです。

npx agent-cards signup    # create an account (one-time)
npx agent-cards setup-mcp # auto-configures Claude Code

これで完了です。Claude Code を再起動すると、ツールを使えるようになります。

手動セットアップ

HTTP（推奨）

MCP クライアントの設定に追加します（Claude Desktop、Cursor など）。

{
  "mcpServers": {
    "agent-cards": {
      "url": "https://mcp.agentcard.sh/mcp",
      "headers": {
        "Authorization": "Bearer <your-jwt>"
      }
    }
  }
}

npx agent-cards login で JWT を取得し、~/.agent-cards/config.json で確認してください。

stdio（ローカル）

{
  "mcpServers": {
    "agent-cards": {
      "command": "node",
      "args": ["/path/to/packages/mcp/dist/src/index.js"],
      "env": {
        "AGENT_CARDS_JWT": "<your-jwt>",
        "AGENT_CARDS_API_URL": "https://your-backend.example.com"
      }
    }
  }
}

ツール

ツール	説明
list_cards	残高、有効期限、ステータスとともに、すべての仮想カードを一覧表示します
create_card	固定の USD 予算を設定した新しい仮想デビットカードを作成します
get_card_details	復号された PAN、CVV、有効期限を取得します（人による承認が必要な場合があります）
check_balance	カード情報を公開せずに、残高をすばやく確認します
close_card	仮想カードを完全に解約します
list_transactions	オプションのステータスフィルターを指定して、カードの取引を一覧表示します
approve_request	人間参加型の保留中のリクエストを承認または拒否します
submit_user_info	カード発行の本人確認用情報を提出します
setup_payment_method	カードへの入金に使う支払い方法を設定します
remove_payment_method	保存済みの支払い方法を削除します
pay_checkout	AgentCard を使ってチェックアウトページを自動検出し、支払います
detect_checkout	現在のブラウザータブでチェックアウトフォームを検出します
fill_card	ブラウザーの支払いフォームにカード情報を入力します
start_support_chat	サポートとの会話を開始します
send_support_message	サポートスレッドにメッセージを送信します
read_support_chat	サポートとの会話履歴を読み取ります

エンドポイント

メソッド	パス	説明
POST	/mcp	MCP Streamable HTTP トランスポート
GET	/health	ヘルスチェック（{"ok":true}）
GET	/.well-known/mcp/server-card.json	自動検出用メタデータ

環境変数

変数	必須	説明
AGENT_CARDS_API_URL	はい	バックエンド API の URL
AGENT_CARDS_JWT	stdio のみ	ユーザー JWT（HTTP では Authorization ヘッダーから取得します）
PORT	いいえ	HTTP サーバーのポート（デフォルト：3002）

開発

pnpm dev       # stdio mode
pnpm dev:http  # HTTP mode
pnpm build     # compile TypeScript