use-agent-wallet

Set up and inspect a Circle agent wallet through the circle CLI.

3|1|Updated May 17, 2026
One-click install
npx skills add https://github.com/levantuy/arc-quantum --skill use-agent-wallet-levantuy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: use-agent-wallet
Source: https://github.com/levantuy/arc-quantum/tree/main/.agents/skills/use-agent-wallet
Command: npx skills add https://github.com/levantuy/arc-quantum --skill use-agent-wallet-levantuy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @circle-fin/cli.

What problem does it solve? AI agents need a programmatic USDC wallet to authenticate and pay for x402 services, but bootstrapping one involves CLI installation checks, Terms-of-Use consent, email OTP login, wallet creation, and balance inspection. This Skill walks through that entire bootstrap flow safely and in the correct order. ## Core Features & Use Cases - CLI Verification & Terms Gate: Checks that the circle CLI is installed, surfaces update notices, and enforces an explicit user-consent flow before accepting Circle's Terms of Use. - Two-Step OTP Login: Handles the non-interactive email + OTP authentication flow, including request ID parsing, OTP prefix validation, and session expiry handling. - Wallet Creation & Inspection: Creates agent-controlled SCA wallets across EVM chains and checks USDC balances per chain and address. - Use Case: A user asks their AI agent to pay for a paid x402 API service. The agent first runs this Skill to confirm the CLI is installed, log the user in via OTP, create the agent wallet on BASE, and check the USDC balance before handing off to a funding or payment skill. ## Quick Start Ask the agent to set up your Circle agent wallet and check its USDC balance on BASE.

Frequently Asked Questions about use-agent-wallet

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a Circle agent wallet with the circle CLI?

Install the CLI with npm install -g @circle-fin/cli, accept the Terms of Use, then log in with circle wallet login using your email and an OTP code. After login, run circle wallet create to provision agent wallets on each supported EVM chain.

How does Circle CLI OTP login work for AI agents?

Circle CLI uses a two-step non-interactive login: circle wallet login <email> --init sends an OTP to your email and returns a request ID, then circle wallet login --request <id> --otp <code> completes authentication. Request IDs expire after 10 minutes and are single-use.

Can the agent accept Circle's Terms of Use automatically?

No. The agent must show the live Terms of Use and Privacy Policy URLs from circle terms show --init and wait for explicit user consent before running circle terms accept. The CIRCLE_ACCEPT_TERMS=1 environment hint must not be used as a workaround.

Why does circle wallet balance require a --chain flag?

The circle CLI requires --chain for wallet list and balance commands because agent wallets exist per EVM chain. Use BASE as the default chain if the user has not specified one, and pass the wallet address from circle wallet list output.

What should I do when the Circle agent wallet has zero USDC?

A zero balance means the wallet cannot pay for x402 services yet. Hand off to the fund-agent-wallet skill, which covers fiat on-ramp purchases, direct address transfers with a QR code, and Gateway deposits.