# genpark-agentcard-autonomous-payment-skill

![Python 3.9+](https://img.shields.io/badge/python-3.9%2B-blue) ![License MIT](https://img.shields.io/badge/license-MIT-green) ![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-purple) ![GenPark AI](https://img.shields.io/badge/GenPark-AI--Agent--Skill-orange)

> **GenPark AI Agent Skill** -- Agentcard autonomous AI agent wallet, programmatic virtual card issuing & MCP payment protocol.

[Agentcard](https://www.agentcard.sh/) enables every AI agent to safely buy things across the web. Single-use and merchant-locked virtual Visa cards ensure funds cannot leak, while human-in-the-loop approvals keep users in complete control.

---

## ⚡ Key Capabilities
- **Single-Use Scoped Cards**: Instant virtual cards locked to specific merchant domains and maximum budgets.
- **One-Call Purchase API**: Automate DoorDash, Uber Eats, flights, cloud services, and 100+ stores.
- **1% Interchange Sharing & Tokenback**: Earn interchange yield on settled volume and reward users.
- **Model Context Protocol (MCP)**: Native integration with Claude Desktop, Cursor, and agent frameworks.

---

## 📊 Architecture Workflow

```mermaid
sequenceDiagram
    autonumber
    actor User as User
    participant Agent as Autonomous AI Agent
    participant AC as Agentcard Wallet Engine
    participant Merchant as Visa / Merchant Gateway

    User->>Agent: "Book flight to SFO under $350"
    Agent->>AC: Request single-use card ($350, united.com)
    AC-->>User: Push Notification / One-tap Approval
    User-->>AC: Approved ✓
    AC-->>Agent: Scoped Virtual Card Issued (•••• 4402)
    Agent->>Merchant: Complete Checkout & Charge
    Merchant->>AC: Settle $328.50 Transaction
    AC->>AC: Destroy Card & Credit 1% Interchange
    Agent-->>User: Order Confirmed & Receipt Delivered
```

---

## 🚀 Quick Start
```bash
python example_usage.py
```

## 🔌 Model Context Protocol (MCP) Server
```bash
python mcp_server.py
```