skills.rest
Surojit012
Surojit012COMMUNITY
Explore all skills by this author →
GitHub

use-agent-wallet

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

Updated Mar 18, 2026
Search Tags:#cli#x402#usdc#circle#agent wallet#crypto payments#otp login
One-click install
npx skills add https://github.com/Surojit012/CMO --skill use-agent-wallet-surojit012
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: use-agent-wallet
Source: https://github.com/Surojit012/CMO/tree/main/.agents/skills/use-agent-wallet
Command: npx skills add https://github.com/Surojit012/CMO --skill use-agent-wallet-surojit012

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @circle-fin/cli.

What problem does it solve? AI agents and developers need a programmatic USDC wallet to authenticate and pay for x402 services, but bootstrapping a Circle agent wallet 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 non-interactively. ## Core Features & Use Cases - CLI Verification & Terms Gate: Checks that the circle CLI is installed and enforces explicit user consent before accepting Circle's Terms of Use. - Two-Step OTP Login: Handles email + OTP authentication designed for non-interactive agent contexts, including request ID parsing and expiry handling. - Wallet Creation & Inspection: Creates agent-controlled SCA wallets across EVM chains and checks USDC balances per chain. - Use Case: An AI agent needs to pay for a paid x402 service. This Skill logs the user into Circle, creates the agent wallet on BASE, checks the balance, and hands off to funding or payment skills. ## 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 CLI?▼

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

How does Circle CLI email OTP login work for AI agents?▼

Run circle wallet login <email> --type agent --init to receive an OTP by email, then complete login with circle wallet login --request <request-id> --otp <code>. Request IDs expire after 10 minutes and are single-use.

How do I check my Circle agent wallet USDC balance?▼

Run circle wallet balance --address <addr> --chain BASE --output json. The --chain flag is required for balance and list commands, with BASE as the default chain.

Why does circle wallet status show a Terms acceptance error?▼

The Circle CLI hard-gates all wallet commands until Terms of Use are accepted on the machine. The agent must show you the live terms URLs and get explicit consent before running circle terms accept.

What happens if my Circle wallet balance is zero USDC?▼

The skill hands off to the fund-agent-wallet skill, which covers fiat on-ramp purchases, direct address transfers with a QR code, and Gateway deposits to fund the wallet.

Related Skills

Explore More Software Engineering Skills→
levantuylevantuy
3

use-agent-wallet

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

Community
Intermediate
levantuylevantuy
3

fund-agent-wallet

Fund Circle agent wallets with USDC via fiat on-ramp, crypto transfer, or Gateway deposit.

Community
Advanced
LightupwrldLightupwrld
1

agent-wallet-policy

View and configure USDC spending limits on Circle agent wallets via the circle CLI.

Community
Intermediate
LightupwrldLightupwrld
1

use-user-controlled-wallets

Build non-custodial wallets with Circle's user-controlled wallets SDK using PIN, email OTP, or social login.

Community
Advanced