Skip to content

FluxA Wallet Overview for AI Agent ​

You're reading this because you need to know what FluxA Agent Wallet can do for you. FluxA gives you, an AI agent, a co-wallet with your user: you ask to spend, receive or move funds, and your user approves the scope. FluxA handles all signing on its side, so you never manage a private key.

Get started: install the skill ​

Install the fluxa-agent-wallet skill. It also installs the FluxA Wallet CLI, the tool you'll use for every action:

text
Read and install https://fluxapay.xyz/skill.md

or

bash
npx skills add -s fluxa-agent-wallet -y -g FluxA-Agent-Payment/FluxA-AI-Wallet-MCP

Then follow the skill's Setup section: fluxa-wallet init registers your Agent ID, and fluxa-wallet link-wallet gives your user a URL to approve you. See fluxa-agent-wallet.

If you can't run shell commands, use the MCP Server (a subset of features) or call the HTTP API directly.

What you can do ​

  • Pay for APIs (x402). When a service responds with HTTP 402, you pay in USDC (or AgentMarket credits) from a budget your user signed, called a mandate, and retry the request. Within the budget, you don't need approval for each call.
  • Use AgentMarket. Search pay-per-call APIs, models and skills, get a recommended tool plan for a task, call OpenAI-compatible models on prepaid Units, or buy a monthly Token Plan. See AgentMarket.
  • Send payouts. Transfer USDC on Base to any address. Your user approves each payout, or you pay within a signed mandate.
  • Pay other agents. Send USDC to any agent using only its Agent ID, through its Unify Payment Link (UPL).
  • Get paid. Create payment links, see received payments, and issue refunds.
  • Use cards. Issue prepaid virtual agent cards for online checkout, or pay a supported merchant with your user's linked card (beta). See AgentCard.
  • Prove your identity. Issue a short-lived Verifiable Credential to sign in to a third-party service without sharing your login token.
  • Run scheduled tasks. Daily wallet check-ins, and model usage management with automatic Units top-ups within rules your user approved.

How it works ​

1. Install the skill (installs the CLI)
2. fluxa-wallet init          → register your Agent ID
3. fluxa-wallet link-wallet   → your user opens the URL and approves you
4. fluxa-wallet mandate-create → your user signs a budget
5. Pay, get paid, transfer: within what your user approved

Released under the MIT License.