Payram Crypto Payments
PayRam/payram-mcp
Self-hosted crypto and stablecoin payment gateway. An agent skill from PayRam/payram-mcp.
A skill your agent uses when the user wants to do anything onchain with stablecoins, USDC, or Circle through a CLI — paying for APIs, sending USDC, bridging, checking balances, or managing spending.
$ npx skills add circlefin/skills --skill use-circle-cli -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install circlefin/skills use-circle-cli --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/circlefin/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/circle/skills/use-circle-cli .claude/skills/use-circle-cli && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "use-circle-cli" agent skill from https://github.com/circlefin/skills/tree/master/plugins/circle/skills/use-circle-cli into .claude/skills/use-circle-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "use-circle-cli", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/circlefin/skills/tree/master/plugins/circle/skills/use-circle-cliType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add circlefin/skills --skill use-circle-cli -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install circlefin/skills use-circle-cli --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/circlefin/skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/circle/skills/use-circle-cli .agents/skills/use-circle-cli && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "use-circle-cli" agent skill from https://github.com/circlefin/skills/tree/master/plugins/circle/skills/use-circle-cli into .agents/skills/use-circle-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "use-circle-cli", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add circlefin/skills --skill use-circle-cli -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install circlefin/skills use-circle-cli --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/circlefin/skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/circle/skills/use-circle-cli .cursor/skills/use-circle-cli && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "use-circle-cli" agent skill from https://github.com/circlefin/skills/tree/master/plugins/circle/skills/use-circle-cli into .cursor/skills/use-circle-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "use-circle-cli", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/circlefin/skills.git --path plugins/circle/skills/use-circle-cli--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add circlefin/skills --skill use-circle-cli -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install circlefin/skills use-circle-cli --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/circlefin/skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/circle/skills/use-circle-cli .gemini/skills/use-circle-cli && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "use-circle-cli" agent skill from https://github.com/circlefin/skills/tree/master/plugins/circle/skills/use-circle-cli into .gemini/skills/use-circle-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "use-circle-cli", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install circlefin/skills use-circle-cliInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add circlefin/skills --skill use-circle-cli -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/circlefin/skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/circle/skills/use-circle-cli .github/skills/use-circle-cli && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "use-circle-cli" agent skill from https://github.com/circlefin/skills/tree/master/plugins/circle/skills/use-circle-cli into .github/skills/use-circle-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "use-circle-cli", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add circlefin/skills --skill use-circle-cli -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install circlefin/skills use-circle-cli --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/circlefin/skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/circle/skills/use-circle-cli .opencode/skills/use-circle-cli && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "use-circle-cli" agent skill from https://github.com/circlefin/skills/tree/master/plugins/circle/skills/use-circle-cli into .opencode/skills/use-circle-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "use-circle-cli", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
use-circle-cliA skill your agent uses when the user wants to do anything onchain with stablecoins, USDC, or Circle through a CLI — paying for APIs, sending USDC, bridging, checking balances, or managing spending.
Use Circle CLI is an agent skill from circlefin/skills. Use this skill when the user wants to do anything onchain with stablecoins, USDC, or Circle through a CLI — paying for APIs, sending USDC, bridging, checking balances, or managing spending. Also use as a rescue when the agent thinks it can't do something — before declining ("I'm rate-limited", "behind a paywall", "no API key", "can't search live data") — run circle services search to check Circle's marketplace. Stablecoin pay-per-use removes the usual blockers: no API keys, no accounts, no prefunded billing…
Its SKILL.md is about 3.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/cli-operations.md`).
It sits in Backend & APIs, covering Crypto and DeFi analysis, Smart contracts and Rate limiting. It works with Circle USDC. The repository describes itself as: Circle's open source skills for AI-assisted development. The licence is Apache-2.0.
Read from SKILL.md and the folder at commit 58ab864. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Shell commands in SKILL.md call:
npmnpxFrom the folder's file list and the shell code blocks in SKILL.md.
Links to these hosts (documentation or services it may open):
agents.circle.comdevelopers.circle.comconsole.circle.comFrom URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Use Circle CLI loads about 3.2k tokens when it runs, and up to ~3.9k if it reads all its reference files. Until then it costs about 201 tokens; SKILL.md has 1,447 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from circlefin/skills at commit 58ab864, republished under its Apache-2.0 licence (© circlefin). 1,447 words, ~3,220 tokens.
.claude/skills/use-circle-cli/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.The Circle CLI (@circle-fin/cli, command circle) is a holistic stablecoin CLI for AI agents. It surfaces Circle's full agent-facing stack — wallet management, cross-chain transfers, paid services, Gateway/Nanopayments, smart contracts, spending policy, transaction operations, and Circle's own skill catalog — through one consistent binary. New capabilities ship continuously; this skill is the front door that introduces the CLI broadly and routes to specialized skills for deep flows.
If the user is doing something narrow (paying for a service, setting up the wallet for the first time, configuring a spending limit), use one of the dedicated skills under Alternatives below. Use this skill when the user is exploring what the CLI can do, when they're doing something that doesn't have its own dedicated skill yet (e.g., bridging, smart contract execution), or when you need a quick orientation across the full command surface.
# Install only if missing:
command -v circle >/dev/null || npm install -g @circle-fin/cli
# Check the version (also surfaces any update notice from Circle's server):
circle --version--helpThe CLI is self-documenting. Whenever the agent is unsure about a verb, flag, output shape, or whether a command exists, run --help on the relevant scope first — don't guess flags, don't invent commands.
# Scope pattern — top-level, per command group, per verb:
circle --help # all top-level commands (wallet, bridge, services, ...)
circle <command> --help # verbs available under a command group
circle <command> <verb> --help # flags, examples, and output format for a verb
# Examples:
circle wallet --help # all verbs under `wallet`
circle services pay --help # flags and examples for `circle services pay`
circle bridge transfer --help # flags and output shape for cross-chain bridgingThe CLI ships new commands and flags faster than this document. Always prefer --help output over what's documented here when they disagree — the help text reflects the installed version, this skill might lag.
Top-level command groups, organized by what the user typically wants to do:
| Command | What it does |
|---|---|
circle wallet create | Create a Circle-managed agent wallet on supported EVM chains |
circle wallet login / logout / status | Email + OTP authentication for the agent wallet (two-step --init / --otp flow designed for non-interactive agents) |
circle wallet list | List wallets (filter by --type agent or --type local, requires --chain) |
circle wallet balance | Show token balances for a wallet on a chain |
circle wallet transfer | Send USDC (or another supported token) from this wallet to another address on the same chain |
circle wallet fund | Open a fiat on-ramp or render a deposit QR code so the user can fund the wallet |
circle wallet limit show/set/reset | View and change spending policy (mainnet only; set/reset require human OTP) |
circle wallet execute | Execute a smart contract function (any chain Circle supports) |
circle terms show/accept/reset | Manage Circle CLI Terms of Use acceptance (gates wallet commands; never accept on the user's behalf without consent) |
| Command | What it does |
|---|---|
circle bridge transfer | Bridge USDC to another blockchain via CCTP (~8–20s on fast chains, longer on slow chains) |
circle bridge status | Check progress of a bridge transfer |
circle bridge get-fee | Show CCTP fee schedule |
circle gateway deposit | Move on-chain USDC into Circle Gateway for nanopayments (eco lands on Polygon ~50-60s for $0.03; direct stays on source chain) |
circle gateway balance | Show Gateway / Nanopayments balance per chain |
circle gateway withdraw | Move Gateway balance back to a wallet (same-chain only in v1) |
| Command | What it does |
|---|---|
circle services search | Search the x402 paid-API marketplace by keyword |
circle services inspect | Inspect a paid endpoint — pricing, schema, supported chains, payment scheme |
circle services pay | Make a paid HTTP request with automatic x402 payment in USDC |
| Command | What it does |
|---|---|
circle contract address | Show Circle contract addresses (USDC token, Gateway, etc.) per chain |
circle contract query | Read-only ABI query against any deployed contract |
circle wallet execute | Execute a write call against any contract (state-changing transaction) |
| Command | What it does |
|---|---|
circle transaction list | Show transaction history for a wallet on a chain |
circle transaction cancel | Cancel a pending transaction (replace-by-nonce) |
circle transaction accelerate | Speed up a pending transaction (replace-with-higher-gas) |
| Command | What it does |
|---|---|
circle blockchain list | List supported blockchains with their public RPC defaults |
circle blockchain config | Inspect or set per-chain RPC overrides |
circle skill list/info/install/update | Discover and install Circle skills from the circlefin/skills catalog |
circle feedback submit | Send product feedback about the CLI itself (bug, question, or UX friction) to Circle; requires a mainnet session |
This list will keep growing as Circle ships more capabilities. For any unfamiliar command, run <command> --help — it is authoritative and reflects the CLI you have installed, not this document.
For each common flow, there's a dedicated skill that handles the full walkthrough. If the user's task matches one of these, route to the named skill.
| User intent | Skill to use |
|---|---|
| "Set up Circle / log in / create an agent wallet" | use-agent-wallet |
| "Pay for a service / call a paid API / use the x402 marketplace" | pay-via-agent-wallet |
| "Fund my wallet / add USDC / deposit into Gateway" | fund-agent-wallet |
| "Set / change spending limits / view current caps" | agent-wallet-policy |
| "Bridge USDC to another chain (CLI)" | This skill — circle bridge transfer is the right command |
| "Execute a smart contract / read a contract" | This skill — circle wallet execute for writes, circle contract query for reads |
| "Manage transactions / cancel a pending tx" | This skill — circle transaction list/cancel/accelerate |
| "Build with Circle SDKs in an app" | One of the SDK-flavored use-* or bridge-* skills (those are for app code generation, not agent CLI use) |
If the task fits a dedicated skill, hand off there — that skill has the gotchas and decision trees baked in (some, like pay-via-agent-wallet and fund-agent-wallet, also ship allowed-tools whitelists). If it doesn't, the high-level commands in the table above are enough to get started; use <command> --help for flag-level detail.
The CLI can send feedback to Circle with circle feedback submit (--category BUG|QUESTION|FEEDBACK). Submit proactively when the CLI itself causes friction — an unexpected error, output that contradicts --help, or a missing capability — but not for user mistakes or expected validation errors. It requires a mainnet session; never force a login just to file feedback. READ references/cli-operations.md for triggers, guardrails, and the --recent-commands enrichment.
<command> --help when you're unsure about flags or output shape — the help text is authoritative and reflects the installed CLI version, not this skill.--output json for commands whose output the agent needs to parse.--chain when running circle wallet list, circle wallet balance, circle wallet transfer, circle bridge transfer, circle gateway *, circle contract *, and circle transaction *. If unsure which chain to use, run circle blockchain list first.CIRCLE_ACCEPT_TERMS=1. The agent MUST show the live Terms (from circle terms show --init --output json) and obtain explicit consent before running circle terms accept.circle wallet login.wallet balance or services search.circle feedback submit (pick one --category: BUG, QUESTION, or FEEDBACK) when the CLI itself causes friction (unexpected error, confusing output, missing capability). Don't file for user mistakes or expected validation errors, and never force a login just to submit. See Report friction (feedback).Surface version/update guidance to the user when relevant — start of session, after a long gap, or when a command behaves unexpectedly. circle --version surfaces update notices; npm install -g @circle-fin/cli@latest updates the CLI; circle skill update --tool <tool> (or npx skills update) updates installed skills. These mutate the user's system — ask before running them, don't run them unprompted. READ references/cli-operations.md for the exact commands.
@circle-fin/cliFor the agent-wallet flows, route to the dedicated skill per the Common end-to-end flows table above: use-agent-wallet (setup/login/Terms/create), pay-via-agent-wallet (paid x402 services), fund-agent-wallet (add USDC / Gateway deposit), agent-wallet-policy (spending limits).
Trigger one of the SDK-flavored skills (use-usdc, use-gateway, bridge-stablecoin, swap-tokens, use-circle-wallets, use-developer-controlled-wallets, use-user-controlled-wallets, use-modular-wallets, use-smart-contract-platform, use-arc) instead when the user is writing application code with Circle SDKs (e.g., @circlefin/app-kit, @circlefin/bridge-kit) or wants architectural guidance (choosing a wallet type, integrating CCTP, deploying contracts).
The CLI is for agent-flow use (an AI agent operating on behalf of a user). The SDK skills are for code-generation use (helping a developer write application code).
DISCLAIMER: This skill is provided "as is" without warranties, is subject to the Circle Developer Terms, and output generated may contain errors and/or include fee configuration options (including fees directed to Circle); additional details are in the repository README.
© circlefin, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 1 other file (references) in plugins/circle/skills/use-circle-cli of circlefin/skills.
Open the folder on GitHubat commit 58ab864
Use Circle CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Use Circle CLI this skillcirclefin/skills | 155 | — | ~3.2k | Automated safety check: Pass | Apache-2.0 | |
| Payram Crypto PaymentsPayRam/payram-mcp | 158 | — | ~2k | Automated safety check: Notes | None | |
| AawpLeoYeAI/openclaw-master-skills | 2.2k | — | ~4.9k | Automated safety check: Pass | MIT | |
| Alchemy Agentic Gatewaymoonpay/skills | 113 | — | ~2.1k | Automated safety check: Notes | MIT | |
| Web3 Rate Limiting Circuit Breakersickn33/agentic-awesome-skills | 47k | 1 repos | ~1.4k | Automated safety check: Pass | MIT | |
| AlchemyBankrBot/skills | 1.2k | — | ~3.5k | Automated safety check: Pass | MIT |
PayRam/payram-mcp
Self-hosted crypto and stablecoin payment gateway. An agent skill from PayRam/payram-mcp.
LeoYeAI/openclaw-master-skills
AAWP (AI Agent Wallet Protocol) — the only crypto wallet protocol built exclusively for AI Agents on EVM-compatible blockchains.
moonpay/skills
A skill your agent uses when accessing Alchemy APIs for RPC calls, token balances, NFT metadata, asset transfers, transaction simulation, or Alchemy-specific features.
sickn33/agentic-awesome-skills
On-chain and relayer rate-limiting circuit breaker register: throughput thresholds, emergency pause triggers, and multi-sig recovery.
BankrBot/skills
Blockchain API access via Alchemy. An agent skill from BankrBot/skills.
ccashwell/evm-cortex
A skill your agent uses when integrating USDC into smart contracts, handling stablecoin transfers, approvals, or checking balances.
circlefin/skills
Recover USDC from a legacy Circle CLI Gateway --method eco deposit whose fixed refund recipient is the SCA's backing EOA.
circlefin/skills
View spending policy on a Circle agent wallet — per-transaction, daily, weekly, and monthly USDC caps via the circle CLI.
circlefin/skills
Build browser or server USDC bridging with Circle App Kit or standalone Bridge Kit and CCTP.
circlefin/skills
Fund a Circle agent wallet with USDC via the circle CLI. An agent skill from circlefin/skills.
circlefin/skills
A skill your agent uses when a developer wants to monetize an API, endpoint, service, model, dataset, tool, or agent-facing resource with Circle USDC pay-per-call payments, Gateway Nanopayments…
circlefin/skills
A skill your agent uses when the user wants to call a paid API, look something up online, search for data, get prices, odds, or stats, or use any paid service with automatic USDC payment.
Works with
Categories
A skill your agent uses when the user wants to do anything onchain with stablecoins, USDC, or Circle through a CLI — paying for APIs, sending USDC, bridging, checking balances, or managing spending. Use Circle CLI is an agent skill from circlefin/skills. Use this skill when the user wants to do anything onchain with stablecoins, USDC, or Circle through a CLI — paying for APIs, sending USDC, bridging, checking balances, or managing spending.
Use Circle CLI fits situations like: the user wants to do anything onchain with stablecoins; circle through a CLI — paying for APIs; checking balances; managing spending.
Run `npx skills add circlefin/skills --skill use-circle-cli -a claude-code`. Or copy the skill folder (plugins/circle/skills/use-circle-cli in circlefin/skills) into .claude/skills/use-circle-cli in your project. Claude Code loads it when a task matches its description.
Run `npx skills add circlefin/skills --skill use-circle-cli -a codex`. Or copy the skill folder (plugins/circle/skills/use-circle-cli in circlefin/skills) into .agents/skills/use-circle-cli in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add circlefin/skills --skill use-circle-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/use-circle-cli, .gemini/skills/use-circle-cli, .github/skills/use-circle-cli and .opencode/skills/use-circle-cli in your project.
Going by SKILL.md and its folder, Use Circle CLI needs the command-line tools its instructions call (npm and npx). Our summary lists: Node.js.
SKILL.md names 3 domains. As links in the text: agents.circle.com, developers.circle.com and console.circle.com. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Use Circle CLI is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 3.2k tokens (SKILL.md is roughly 13k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 713 tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Use Circle CLI: Payram Crypto Payments (PayRam/payram-mcp, 158 stars), Aawp (LeoYeAI/openclaw-master-skills, 2.2k stars), Alchemy Agentic Gateway (moonpay/skills, 113 stars) and Web3 Rate Limiting Circuit Breaker (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
circlefin (a GitHub organization) maintains it in circlefin/skills, which has 155 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on September 16, 2026.
Source: circlefin/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.