Circle Skills plugin
Circle's official plugin: 19 skills on USDC, wallets, bridges and agent payments, plus a remote MCP server with the docs
- 165 ★ on the repository
- Last commit
- Apache-2.0
Broad access
Why this level
- The agent wallet and x402 skills lead to real USDC transfers, and the bridge adapters accept a private key
- The wallet login uses an email and a one-time code, and the balance and history stay with Circle
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/circle-skillsDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The agent wallet and x402 skills lead to real USDC transfers, and the bridge adapters accept a private key
- The wallet login uses an email and a one-time code, and the balance and history stay with Circle
This is third-party code. Review the repository files before installing.
What it does
The Circle plugin installs 19 skills for apps built on the USDC stablecoin. They cover USDC transfers and balances on EVM chains and Solana, crosschain bridges through CCTP, a unified balance through Gateway, three wallet types, smart contracts, token swaps, card purchases of crypto and the Arc blockchain. Each skill gives the agent decision rules and common mistakes: when to pick CCTP and when Gateway, why USDC has six decimals, how the approve-then-deposit order works. A separate group of skills runs an agent wallet through the `circle` CLI. The agent signs in with an email and a one-time code, creates a wallet, funds it, finds paid services over the x402 protocol and pays per call. Another skill teaches how to accept such payments on your own endpoint. The bundle also points to Circle's MCP server at `https://api.circle.com/v1/codegen/mcp`. It serves current SDK signatures and contract addresses that the skills do not store.
Who it is for. Teams building payments, wallets or bridges on USDC that want their Claude Code, Cursor or Codex agent to follow Circle's own patterns.
Good fit when
- Your app needs one USDC balance across several chains and you are choosing between Gateway and the CCTP bridge
- A site has to embed a widget for buying crypto by card or bank transfer
- An agent has to pay for APIs over x402 from a Circle wallet, and you want to see the price before paying
- A paid endpoint for agents takes USDC per call and needs the seller side
- You build on Arc, where USDC is the native gas token, and need network setup and contract deployment
Not a fit when
- The project does not use USDC or Circle infrastructure: the skills describe only its products
- You need investment or crypto tax advice: the skills are about code and integrations
- The agent handles live money unsupervised: run the payment skills on a testnet first
Example request
Decide whether my USDC app on Base and Solana should use Gateway or CCTP, and show how to build a transfer with kit.bridge()Limitations
- The skills hold patterns that rarely change. Circle advises taking contract addresses and SDK signatures from the MCP server, and without it the agent can lag behind the SDK version.
- The disclaimer says output may contain errors and that some fee options direct fees to Circle Technology Services, LLC. The project owner reviews fee settings in generated code.
- The agent wallet flow needs the `circle` CLI, acceptance of the terms of use and an email login.
How to disable. In Claude Code `/plugin uninstall circle-skills@circle` removes the plugin. Skills installed with `npx skills add` are deleted from the agent's skills folder. `claude mcp remove circle` drops the MCP server.
FAQ
How do I install Circle Skills in Claude Code?
Run `/plugin marketplace add circlefin/skills`, then `/plugin install circle-skills@circle`. For other agents use `npx skills add circlefin/skills`. Updates come through `/plugin marketplace update` or `npx skills update`.
Do I need Circle's MCP server for the skills to work?
No, the skills work on their own. MCP adds current SDK signatures and contract addresses that change between versions. For Claude Code connect it with `claude mcp add --transport http circle https://api.circle.com/v1/codegen/mcp --scope user`, for Codex with `codex mcp add circle --url https://api.circle.com/v1/codegen/mcp`.
Do the skills write code for me?
The agent writes the code and the skills give it rules: which Circle product to pick and which mistakes to avoid. Decisions about fees and money stay with you.
Which chains and wallets do the skills cover?
USDC on EVM chains and Solana, the Arc blockchain, developer-controlled wallets, user-controlled wallets and modular wallets with passkeys. The `use-circle-wallets` skill helps pick a type by key custody model.
How does an agent pay for x402 services?
Through the `circle` CLI. The `use-agent-wallet` skill creates a wallet with an email and one-time code login, `fund-agent-wallet` tops it up, and `pay-via-agent-wallet` walks from finding a service and inspecting its price to paying with chain selection.
Discussion
No questions or reviews yet.
Related
PluginsA Python CLI and SDK for agent payments in USDC: transfers from Circle wallets and paid API calls over the x402 protocol
Coinbase's official skill: sign-in, balance, transfers and token swaps through the awal CLI on Base, Polygon and Solana.
Skills for crypto agents: wallets, token swaps, onchain data and protocols such as Uniswap, Base, Alchemy and Zerion, each installed on its own
A CLI with an MCP server and a skill: the agent calls paid APIs while the user approves each HTTP 402 stablecoin payment with Touch ID
The Minara skill gives an agent the crypto market in plain language: wallet, token swaps, Hyperliquid perps, limit orders and market analytics
Stripe's official MCP server, plugins and skills: the agent searches the API and docs, reads and changes account data
README in short
The README begins with two install routes and a table of skills with a short description of each. Then come MCP server setup for Cursor, Claude Code, Codex and Windsurf, a note on how skills steer an agent, the update routine, an FAQ and a disclaimer.