skills.rest
FuzzysTodd
FuzzysToddCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

use-agent-wallet

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

1|Updated Sep 4, 2025
Search Tags:#cli#x402#usdc#circle#agent wallet#crypto payments#otp login
One-click install
npx skills add https://github.com/FuzzysTodd/The-Nexus-Protocol-Token-DAO --skill use-agent-wallet-fuzzystodd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: use-agent-wallet
Source: https://github.com/FuzzysTodd/The-Nexus-Protocol-Token-DAO/tree/main/skills/use-agent-wallet
Command: npx skills add https://github.com/FuzzysTodd/The-Nexus-Protocol-Token-DAO --skill use-agent-wallet-fuzzystodd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @circle-fin/cli.

What problem does it solve? Setting up Circle's programmatic USDC wallet for AI agents involves several gated steps — CLI installation, Terms-of-Use consent, email + OTP login, wallet creation, and balance checks — that are easy to get wrong or run out of order. This Skill walks through the entire bootstrap flow correctly, including the mandatory consent gate and session validation. ## Core Features & Use Cases - CLI Verification & Terms Gate: Checks that the circle CLI is installed, then handles the Terms-of-Use acceptance flow with explicit user consent before any wallet command runs. - Two-Step OTP Login: Guides the non-interactive email + OTP authentication flow (circle wallet login --init then --request/--otp), including request ID parsing and expiry handling. - Wallet Creation & Inspection: Creates agent-controlled SCA wallets across EVM chains and checks USDC balances per chain (defaulting to BASE). - Use Case: An AI agent needs to pay for a paid x402 service. Before any payment can happen, this Skill bootstraps the wallet: verify CLI, accept Terms with consent, log in via OTP, create the wallet, and confirm the balance — then hand off to funding or payment skills. ## Quick Start Set up my Circle agent wallet: check if the circle CLI is installed, log me in with my email, create the wallet, and show my 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 from the CLI?▼

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

How does Circle CLI login work for AI agents?▼

Circle CLI uses a two-step non-interactive OTP flow: circle wallet login <email> --init sends a code 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.

Why does circle wallet status say Terms acceptance is required?▼

The Circle CLI hard-gates all wallet commands until the Terms of Use and Privacy Policy are accepted on that machine. The user must review the live terms URLs and explicitly consent before the agent runs circle terms accept; the agent must never accept on the user's behalf.

Does circle wallet balance require a chain parameter?▼

Yes, the --chain flag is required for both circle wallet list and circle wallet balance. BASE is the recommended default chain if the user has not specified one, and the balance command also needs the wallet address from the list output.

What happens if my Circle CLI OTP or request ID expires?▼

Request IDs are single-use and expire after 10 minutes, so an expired or invalid ID error means you must restart from circle wallet login --init to generate a fresh OTP. Do not retry the same request ID in a loop.

When should I use fund-agent-wallet instead of this setup flow?▼

Use fund-agent-wallet when the agent wallet already exists but holds 0 USDC and the user wants to add funds via fiat on-ramp, QR-code transfer, or Gateway deposit. This setup skill only covers bootstrap: install, login, wallet creation, and balance inspection.

Related Skills

Explore More Software Engineering Skills→
builders-gardenbuilders-garden
43

siwa-circle

Automate SIWA signing with Circle wallets for agent identity across Next.js, Express, Hono, and Fastify.

Official
Intermediate
clawgameclawgame
1

pay-for-service

Automate paid API calls by paying USDC on x402 endpoints.

Community
Intermediate
JamkrisJamkris
86

agent-payment-x402

Automate AI agent payments with x402 protocol and MCP tools.

Community
Advanced
zkp2pzkp2p
2

peer-transfer

Transfer USDC directly between agent wallets on Base without escrow.

Official
Advanced