Skip to content

fluxa-agent-wallet

A CLI-based Agent Skill that gives AI agents onchain payment capabilities via a bundled Node.js command-line tool. The agent invokes shell commands and receives JSON output — no private key management required.

What it does

CapabilityCLI commandsDescription
X402 Paymentmandate-create, mandate-status, x402-v3Pay for x402-enabled APIs using intent mandates
Payoutpayout, payout-statusSend USDC to any wallet address on Base
Payment Linkpaymentlink-create, paymentlink-list, paymentlink-get, paymentlink-update, paymentlink-delete, paymentlink-paymentsCreate and manage shareable payment collection links

All commands return JSON on stdout with exit code 0 (success) or 1 (failure). Amounts are in atomic units (1 USDC = 1000000).

Requirements

  • Node.js v18+

GitHub

github.com/FluxA-Agent-Payment/FluxA-AI-Wallet-MCP/tree/main/skills/fluxa-agent-wallet

Install

Claude Code

bash
git clone https://github.com/FluxA-Agent-Payment/FluxA-AI-Wallet-MCP.git
cp -r FluxA-AI-Wallet-MCP/skills/fluxa-agent-wallet .claude/skills/

Claude Code discovers the skill automatically on next start.

Claude.ai

  1. Download or clone the repo.
  2. Zip the skills/fluxa-agent-wallet/ directory.
  3. Upload in Settings > Features > Skills.

Claude API

bash
cd FluxA-AI-Wallet-MCP/skills
zip -r fluxa-agent-wallet.zip fluxa-agent-wallet/
curl -X POST https://api.anthropic.com/v1/skills \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-beta: skills-2025-10-02" \
  -F "file=@fluxa-agent-wallet.zip"

Skill structure

fluxa-agent-wallet/
├── SKILL.md              ← Main instructions + decision flow
├── X402-PAYMENT.md       ← x402 v3 intent mandate payment flow
├── PAYOUT.md             ← Send USDC to external addresses
├── PAYMENT-LINK.md       ← Create and manage payment links
└── scripts/
    └── fluxa-cli.bundle.js   ← Bundled CLI binary

Released under the MIT License.