use-circle-cli

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @circle-fin/cli.

What problem does it solve? AI agents often hit blockers like paywalls, rate limits, missing API keys, or lack of onchain capability. This Skill provides a single entry point to the Circle CLI, letting an agent manage USDC wallets, bridge funds across chains, pay for APIs with stablecoins, and execute smart contracts without accounts or prefunded billing. ## Core Features & Use Cases - Wallet & Identity Management: Create agent wallets, authenticate via email OTP, check balances, transfer USDC, and manage spending policies across supported EVM chains. - Cross-Chain & Payments: Bridge USDC via CCTP, deposit into Circle Gateway for nanopayments, and pay for x402 marketplace services with automatic stablecoin settlement. - Smart Contracts & Transactions: Query and execute contract calls, list transaction history, and cancel or accelerate pending transactions. - Use Case: An agent needs live data but hits a paywalled API. It runs circle services search to find a paid endpoint, inspects pricing, and pays per request in USDC — no API key or account signup required. ## Quick Start Ask the agent to check your Circle wallet balance or search the x402 marketplace for a paid API, and it will install the Circle CLI if needed and run the appropriate command with --help guidance.

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 an API with USDC using Circle CLI?

Use `circle services search` to find a paid endpoint in the x402 marketplace, `circle services inspect` to check pricing and supported chains, then `circle services pay` to make the request with automatic USDC payment. No API keys or accounts are required.

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

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

How do I install and set up the Circle CLI?

Install globally with `npm install -g @circle-fin/cli`, then verify with `circle --version`. Wallet setup requires `circle wallet create` and email OTP login via `circle wallet login`, plus explicit Terms of Use acceptance.

Does Circle CLI support testnet or only mainnet?

The agent wallet flow defaults to mainnet unless the user explicitly requests testnet. Spending policy features (`circle wallet limit`) are mainnet-only, so testnet wallets cannot enforce spending caps.

When should I use Circle CLI versus Circle SDKs?

Use the CLI when an AI agent operates on behalf of a user for tasks like payments, bridging, or wallet management. Use Circle SDKs (like bridge-kit or developer-controlled-wallets) when writing application code that integrates Circle services.

Why does my Circle CLI command fail with missing chain errors?

Commands like `wallet balance`, `bridge transfer`, `gateway`, `contract`, and `transaction` require an explicit `--chain` flag. Run `circle blockchain list` to see supported chains and their RPC defaults before retrying.