use-circle-cli

Operate Circle CLI for USDC wallets, bridging, and x402 paid services.

1|Updated Jul 20, 2026
One-click install
npx skills add https://github.com/Lightupwrld/Cycuxio --skill use-circle-cli-lightupwrld
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: use-circle-cli
Source: https://github.com/Lightupwrld/Cycuxio/tree/main/.agents/skills/use-circle-cli
Command: npx skills add https://github.com/Lightupwrld/Cycuxio --skill use-circle-cli-lightupwrld

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @circle-fin/cli.

What problem does it solve? AI agents often hit paywalls, rate limits, or missing API keys when trying to access paid services or perform onchain actions. This Skill teaches the agent to use the Circle CLI to manage USDC wallets, bridge funds across chains, and pay for x402-gated APIs without accounts or API keys. ## Core Features & Use Cases - Wallet & Identity Management: Create agent wallets, authenticate via email OTP, check balances, transfer USDC, and manage spending limits across supported EVM chains. - Cross-Chain & Contract Operations: Bridge USDC via CCTP, deposit into Circle Gateway for nanopayments, and execute or query smart contracts from the command line. - Paid Service Access (x402): Search, inspect, and pay for x402 marketplace APIs with automatic USDC payment, removing the need for API keys or prefunded billing. - Use Case: An agent needs live data behind a paywall. It runs circle services search to find a provider, inspects pricing, and pays per request in USDC — no signup required. ## Quick Start Ask the agent to check your Circle wallet balance and search the x402 marketplace for a paid API you need.

Frequently Asked Questions about use-circle-cli

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

FAQPage Schema
How do I pay for a paid API with USDC using Circle CLI?

Use `circle services search` to find an x402 paid endpoint, `circle services inspect` to check pricing and supported chains, then `circle services pay` to make the request with automatic USDC payment. No API key or account signup is required.

How do I bridge USDC to another blockchain from the command line?

Run `circle bridge transfer` with the appropriate `--chain` flag to move USDC across chains via CCTP. Transfers take roughly 8-20 seconds on fast chains; check progress with `circle bridge status`.

What can the Circle CLI do for AI agents?

The Circle CLI covers wallet creation and login, USDC transfers, cross-chain bridging, Gateway nanopayments, x402 paid API access, smart contract reads and writes, transaction management, and spending policy configuration. Run `circle --help` for the full command surface.

Does Circle CLI require accepting Terms of Use before using wallets?

Yes, wallet commands are gated by Circle's Terms of Use. The agent must show the live terms via `circle terms show --init --output json` and obtain explicit user consent before running `circle terms accept`; it must never accept on the user's behalf.

Why should I run --help instead of relying on documented Circle CLI flags?

The CLI ships new commands and flags faster than documentation updates, so `--help` output reflects the installed version and is authoritative. Always run `circle <command> --help` when unsure about verbs, flags, or output shape.

When should I use a dedicated Circle skill instead of this one?

Use `use-agent-wallet` for wallet setup and login, `pay-via-agent-wallet` for x402 service payments, `fund-agent-wallet` for deposits, and `agent-wallet-policy` for spending limits. This skill covers broader flows like bridging, contracts, and transactions.