Ship stablecoin apps faster with Circle Skills: best-practice guidance for USDC payments, crosschain transfers, wallets, and smart contracts, plus Circle's MCP server for real-time SDK and documentation context.
/plugin marketplace add circlefin/skills
/plugin install circle-skills@circle
npx skills add circlefin/skills| Skill | Description |
|---|---|
use-usdc |
Interact with USDC on EVM chains and Solana. Check balances, send transfers, approve spending, and verify transactions. |
bridge-stablecoin |
Crosschain USDC transfers using CCTP (Crosschain Transfer Protocol). Includes UX patterns, progress tracking, and Bridge Kit SDK implementation. |
use-arc |
Build on Arc, Circle's blockchain where USDC is the native gas token. Covers chain configuration, contract deployment, and bridging USDC to Arc via CCTP. |
use-circle-wallets |
Choose the right Circle wallet type. Compares developer-controlled, user-controlled, and modular (passkey) wallets across custody model, key management, and use cases. |
use-developer-controlled-wallets |
Developer-controlled wallets for custodial flows like payouts, treasury management, and automation. Developers manage wallet creation and key storage. |
use-gateway |
Unified USDC balance across chains with instant crosschain transfers (<500ms). Supports EVM and Solana with deposit, balance query, and transfer workflows. |
use-modular-wallets |
Smart contract wallets with passkey authentication, gasless transactions, and modular architecture. Supports ERC-4337 account abstraction. |
use-smart-contract-platform |
Deploy, import, interact with, and monitor smart contracts using Circle's Smart Contract Platform. Supports bytecode deployment, template contracts (ERC-20/721/1155), ABI-based read/write calls, and event monitoring. |
use-user-controlled-wallets |
Embedded wallets where users control their own assets. Supports Web2-like login (Google, Facebook, Apple, email OTP, PIN) without seed phrases. |
Skills contain stable patterns (architecture decisions, UX guidance, common mistakes). For ground-truth details that change frequently (e.g., SDK method signatures, contract addresses, chain IDs) use Circle's MCP server alongside skills.
| Client | Setup |
|---|---|
| Cursor | Add to ~/.cursor/mcp.json |
| Claude Code | claude mcp add --transport http circle https://api.circle.com/v1/codegen/mcp --scope user |
| Codex | codex mcp add circle --url https://api.circle.com/v1/codegen/mcp |
| Windsurf | Add to ~/.codeium/windsurf/mcp_config.json |
Manual config for Cursor, Windsurf, and other JSON-based clients:
{
"mcpServers": {
"circle": {
"url": "https://api.circle.com/v1/codegen/mcp"
}
}
}Full setup guide: developers.circle.com/ai/mcp
Skills provide context that help agents do specific things with greater accuracy:
- Decision frameworks: when to use CCTP vs Gateway, which wallet type fits your use case
- Correct patterns: USDC's 6-decimal rule, approve-then-deposit flows, passkey recovery
- Common mistakes: what breaks and why, so the agent avoids them upfront
Your agent reads the relevant SKILL.md while planning and generating code. You stay in control of what gets built.
Skills are local files. To get the latest versions:
# Vercel CLI
npx skills update
# Claude Code
/plugin marketplace updateSkills are designed around patterns with infrequent changes, so they remain useful even if slightly behind. For details that change often (contract addresses, SDK signatures), use Circle MCP which updates over the air.
We accept issues openly — bug reports, skill requests, and feedback are welcome. We review community suggestions and use them to guide what we build, but don't guarantee merging external contributions.
Do skills write code for me? No. Skills are instructions and best-practice patterns that steer an agent's outputs. Your agent generates the code; skills guide it.
Do I need the MCP server? No. Skills work standalone. MCP adds accuracy for SDK details that change between versions.
By using this skill, you acknowledge that any output generated in connection with the Skill may contain errors, omissions, outdated information, or fee configuration options, including options under which applicable fees may be directed to Circle Technology Services, LLC, and you are solely responsible for reviewing and validating all outputs and fee settings before taking any action. This skill is provided "as is," and Circle Technology Services, LLC disclaims liability for losses or damages arising from use of or reliance on output generated in connection with this skill; use of this skill is subject to the Circle Developer Terms and Conditions.
Apache 2.0 — see LICENSE for details.
