bitpro가 원문에서 글자만 모은 내용이에요. 표·그림·수식은 빠지거나 깨질 수 있어요. 전체 75쪽 중 5쪽
-data`, `-d` | Request body as a JSON string. Overrides the auto-generated body. |
| `--header`, `-H` | Custom request header as `Key: Value`. Repeat the flag to send multiple. |
**Example**
```bash theme={null}
circle services inspect https://api.example.com/weather -X POST -d '{"city":"SF"}'
```
***
### `circle services pay`
Pay for a service using your agent wallet.
**Syntax**
```bash theme={null}
circle services pay <url> --address <address> --chain <chain> [options]
```
**Arguments**
| Argument | Description |
| :- | :- |
| `<url>` | Service URL to pay for. |
**Options**
| Option | Description |
| :- | :- |
| `--address` | Agent wallet address. |
| `--chain` | Blockchain to pay from. |
| `--max-amount <usdc>` | Refuse to pay more than this amount in USDC (for example, `0.01`). |
| `--method`, `-X` | HTTP method: `GET`, `POST`, `PUT`, `DELETE`, `PATCH`. Defaults to `GET`. |
| `--data`, `-d` | Request body as a JSON string. |
| `--header`, `-H` | Custom request header as `Key: Value`. |
| `--estimate` | Show payment requirements without submitting payment. |
| `--quiet`, `-q` | Print response body only (useful for piping). |
| `--timeout <seconds>` | Per-step timeout in seconds. Defaults to `30`. |
**Example**
```bash theme={null}
circle services pay https://api.example.com/weather --address 0x... --chain ARC
```
<Tip>
Failed payments write debug logs to `~/.circle-cli/payments/`. Check the most
recent file for the request, response, and stage where the failure occurred.
</Tip>
***
## Bridge commands
Bridge USDC across blockchains using [CCTP](/cctp).
### `circle bridge transfer`
Bridge USDC from one blockchain to another.
**Syntax**
```bash theme={null}
circle bridge transfer <toChain> [<recipient>] --amount <amount> --address <addr> --chain <from>
```
**Arguments**
| Argument | Description |
| :- | :- |
| `<toChain>` | Destination blockchain (for example, `ARC`). |
| `[<recipient>]` | Recipient address on the destination. Defaults to the value of `--address`. |
**Options**
| Option | Description |
| :- | :- |
| `--amount` | USDC amount the recipient will receive. |
| `--address` | Sender wallet address. |
| `--chain` | Source blockchain. |
| `--rpc-url` | RPC endpoint override for the source blockchain. |
| `--idempotency-key` | Unique key to prevent duplicate transfers on retry. |
| `--quiet`, `-q` | Print transaction hash only (useful for piping). |
**Example**
```bash theme={null}
circle bridge transfer ARC --amount 10.0 --address 0x... --chain BASE
```
***
### `circle bridge status`
Check the status of a bridge transfer by transaction hash.
**Syntax**
```bash theme={null}
circle bridge status <txHash> --chain <chain>
```
**Arguments**
| Argument | Description |
| :- | :- |
| `<txHash>` | Transaction hash of the burn transaction. |
**Options**
| Option | Description |
| :- | :- |
| `--chain` | Source blockchain. |
**Example**
```bash theme={null}
circle bridge status 0xabc... --chain BASE
```
***
### `circle bridge get-fee`
Get the estimated fee for bridging from a given blockchain.
**Syntax**
```bash theme={null}
circle bridge get-fee <to> --chain <from>
```
**Arguments**
| Argument | Description |
| :- | :- |
| `<to>` | Destination blockchain (for example, `ARC`). |
**Options**
| Option | Description |
| :- | :- |
| `--chain` | Source blockchain. |
**Example**
```bash theme={null}
circle bridge get-fee ARC --chain BASE
```
***
## Gateway commands
Interact with [Circle Gateway](/gateway).
### `circle gateway balance`
Show your Gateway balance for nanopayments.
**Syntax**
```bash theme={null}
circle gateway balance --address <addr> --chain <chain> [options]
```
**Options**
| Option | Description |
| :- | :- |
| `--address` | Wallet address. |
| `--chain` | Blockchain where the wallet lives. Any [Gateway-supported blockchain](/gateway/references/supported-blockchains) is valid. |
| `--all` | Show all blockchains including those with zero balances. |
| `--rpc-url` | RPC endpoint override. Required for local wallets without a configured default. |
**Examples**
```bash theme={null}
circle gateway balance --address 0x... --chain ARC
circle gateway balance --address 0x... --chain ARC --all
```
***
### `circle gateway deposit`
Deposit USDC into Circle Gateway for nanopayments. Minimum deposit is `0.5`
USDC.
**Syntax**
```bash theme={null}
circle gateway deposit --amount <usdc> --address <addr> --chain <chain> [--method <method>] [options]
```
**Options**
| Option | Description |
| :- | :- |
| `--amount` | Amount of USDC to deposit. |
| `--address` | Wallet address. |
| `--chain` | Source blockchain. With `--method eco`, use `BASE`. With `--method direct`, any [Gateway-supported blockchain](/gateway/references/supported-blockchains) is valid. |
| `--method` | Agent wallet deposit method: `eco` or `direct`. Required for agent wallets. Omit for local wallets, which always use a direct onchain deposit. |
| `--timeout` | Total timeout in seconds for source transfer confirmation and Eco settlement polling. Defaults to `120`. |
| `--no-wait` | With `--method eco`, return after the source transfer confirms instead of waiting for Eco to publish the deposit. |
<Note>
Eco is a third-party fast-deposit service that Circle does not operate or
audit. Test the flow before using it in production.
</Note>
Eco deposits use a quoted, single-use vault for each deposit. The CLI funds the
quoted amount before its deadline and waits for Eco to publish the deposit by
default. Use the `destinationChain` from the output for subsequent
`circle gateway balance` and `circle services pay` commands.
JSON output for Eco deposits includes `vaultAddress`, `deadline`,
`destinationChain`, `gatewayDomain`, `transferTxHash`, and the last known
`state`. On mainnet, Eco deposits settle on Arc. A timeout while Eco is still
settling doesn't mean the deposit failed; check the destination balance. Failed
or expired deposits return USDC to the agent wallet and exit with an error.
**Example**
```bash theme={null}
circle gateway deposit --amount 5 --address 0x... --chain BASE --method eco
```
***
### `circle gateway withdraw`
Withdraw USDC from Circle Gateway back to a wallet on the same blockchain.
**Syntax**
```bash theme={null}
circle gateway withdraw --amount <usdc> --address <addr> --chain <chain> [options]
```
**Options**
| Option | Description |
| :- | :- |
| `--amount` | Amount of USDC to withdraw. |
| `--address` | Source wallet address (the Gateway depositor). |
| `--chain` | Source blockchain. Any [Gateway-supported blockchain](/gateway/references/supported-blockchains) is valid. |
| `--recipient` | Destination address to receive USDC. Defaults to `--address`. |
| `--timeout` | Mint transaction poll timeout in seconds. Defaults to `120`. Agent wallets only. |
<Note>
Withdrawals are same-chain only. The withdrawn USDC is minted on `--chain`.
Agent wallets must be Smart Contract Accounts (SCAs). Pass the SCA address as
`--address`. JSON output includes `transferId`, `estimatedFee`, and
`chargedFee`.
</Note>
**Examples**
```bash theme={null}
# Withdraw to your own wallet
circle gateway withdraw --amount 0.1 --address 0x... --chain ARC
# Withdraw to a different recipient
circle gateway withdraw --amount 5 --address 0x... --chain ARC --recipient 0xOTHER
```
***
## Blockchain commands
Query supported blockchain information.
### `circle blockchain list`
List all blockchains supported by Circle CLI.
**Syntax**
```bash theme={null}
circle blockchain list
```
***
### `circle blockchain config`
Show or update the RPC URL for a blockchain.
**Syntax**
```bash theme={null}
circle blockchain config --chain <chain> [options]
```
**Options**
| Option | Description |
| :- | :- |
| `--chain` | Blockchain to configure. |
| `--rpc-url` | Set a custom RPC URL override for this blockchain. |
| `--default` | Reset to the default RPC URL. Cannot be used with `--rpc-url`. |
**Examples**
```bash theme={null}
circle blockchain config --chain ARC --output json
circle blockchain config --chain ARC --rpc-url https://my-node.example.com
circle blockchain config --chain ARC --default
```
***
## Transaction commands
Manage pending and submitted transactions.
### `circle transaction list`
List transaction history for a wallet.
**Syntax**
```bash theme={null}
circle transaction list --address <addr> --chain <chain> [options]
```
**Options**
| Option | Description |
| :- | :- |
| `--address` | Wallet address. |
| `--chain` | Blockchain. |
| `--operation` | Filter by operation: `transfer` or `execute`. |
| `--state` | Filter by state: `initiated`, `queued`, `sent`, `confirmed`, `complete`, `failed`, `cancelled`, `denied`, `cleared`, `stuck`. |
| `--tx-type` | Filter by direction: `inbound` or `outbound`. |
| `--lowest-nonce` | Return only the lowest-nonce pending transaction. Ignores other filters. |
| `--cursor` | Pagination token: return transactions after this ID. |
| `--limit` | Maximum number of transactions to return. Defaults to `50`. |
**Examples**
```bash theme={null}
circle transaction list --address 0x... --chain ARC
circle transaction list --address 0x... --chain ARC --operation transfer --state confirmed
```
***
### `circle transaction cancel`
Cancel a pending transaction.
**Syntax**
```bash theme={null}
circle transaction cancel <id> --address <addr> --chain <chain>
```
**Arguments**
| Argument | Description |
| :- | :- |
| `<id>` | Transaction ID. |
**Options**
| Option | Description |
| :- | :- |
| `--address` | Wallet address. |
| `--chain` | Blockchain. |
**Example**
```bash theme={null}
circle transaction cancel abc-123 --address 0x... --chain ARC
```
***
### `circle transaction accelerate`
Accelerate a pending transaction by increasing the gas fee.
**Syntax**
```bash theme={null}
circle transaction accelerate <id> --address <addr> --chain <chain>
```
**Arguments**
| Argument | Description |
| :- | :- |
| `<id>` | Transaction ID. |
**Options**
| Option | Description |
| :- | :- |
| `--address` | Wallet address. |
| `--chain` | Blockchain. |
**Example**
```bash theme={null}
circle transaction accelerate abc-123 --address 0x... --chain ARC
```
***
## Contract commands
Interact with onchain contracts.
### `circle contract address`
Show Circle contract addresses, optionally filtered by category and blockchain.
**Syntax**
```bash theme={null}
circle contract address [category] [--chain <chain>]
```
**Arguments**
| Argument | Description |
| :- | :- |
| `[category]` | Contract category to filter by (for example, `usdc`, `cctp`, `gateway`). |
**Options**
| Option | Description |
| :- | :- |
| `--chain` | Filter by blockchain. |
**Examples**
```bash theme={null}
circle contract address usdc --chain ARC
circle contract address cctp --output json
```
***
### `circle contract query`
Execute a read-only contract call.
**Syntax**
```bash theme={null}
circle contract query <abiFunctionSignature> [abiParameters...] --contract <address> --chain <chain>
```
**Arguments**
| Argument | Description |
| :- | :- |
| `<abiFunctionSignature>` | ABI function signature (for example, `balanceOf(address)`). |
| `[abiParameters...]` | ABI parameters, space-separated (for example, `0x1234...`). |
**Options**
| Option | Description |
| :- | :- |
| `--contract` | Contract address. |
| `--chain` | Blockchain to query. |
**Examples**
```bash theme={null}
circle contract query "balanceOf(address)" 0xWALLET --contract 0xUSDC --chain ARC
circle contract query "totalSupply()" --contract 0xUSDC --chain ARC --output json
```
***
## Skill commands
Discover and install skills from the
[`circlefin/skills`](https://github.com/circlefin/skills) catalog.
<Note>
The `--tool` option specifies your agent framework. Common values:
`claude-code`, `cursor`, `codex`.
</Note>
### `circle skill list`
List all available skills from the catalog.
**Syntax**
```bash theme={null}
circle skill list [--output json]
```
**Options**
| Option | Description |
| :- | :- |
| `--output json` | Return results as JSON. |
***
### `circle skill info`
Show details and full content for a specific skill.
**Syntax**
```bash theme={null}
circle skill info --name <name>
```
**Options**
| Option | Description |
| :- | :- |
| `--name` | Name of the skill to inspect. |
**Example**
```bash theme={null}
circle skill info --name <skill-name>
```
***
### `circle skill install`
Install a skill into your agent framework.
**Syntax**
```bash theme={null}
circle skill install --tool <tool> [--name <name>]
```
**Options**
| Option | Description |
| :- | :- |
| `--tool` | Agent framework to install into. Use multiple `--tool` options for more than one framework. |
| `--name` | Skill name to install. Omit to install all available skills. |
**Examples**
```bash theme={null}
circle skill install --tool claude-code --name <skill-name>
circle skill install --tool cursor --tool codex --name <skill-name>
```
***
### `circle skill update`
Update installed skills for an agent framework.
**Syntax**
```bash theme={null}
circle skill update --tool <tool>
```
**Options**
| Option | Description |
| :- | :- |
| `--tool` | Agent framework to update skills for. |
***
## Terms commands
Inspect, accept, or reset your local Circle CLI Terms of Use acceptance record.
The first time you run any command, Circle CLI prompts you to accept the Terms
of Use and Privacy Policy. Acceptance is stored locally and reused on subsequent
runs. To handle Terms acceptance non-interactively in scripts and AI agents, use
`circle terms accept` or set `CIRCLE_ACCEPT_TERMS=1` in the environment.
### `circle terms`
Show the current acceptance status and the canonical Terms of Use and Privacy
Policy URLs. Default verb is `show`.
**Syntax**
```bash theme={null}
circle terms [show] [options]
```
**Options**
| Option | Description |
| :- | :- |
| `--init` | Return Terms info (version, URLs, notice text) for an agent to present before calling `accept`. Implies `--output json`. |
**Examples**
```bash theme={null}
circle terms
circle terms --output json
circle terms show --init --output json
```
**JSON output**
```json theme={null}
{
"accepted": true,
"currentVersion": "1.0.0",
"termsOfUseUrl": "https://www.circle.com/legal/circle-cli-terms-of-use",
"privacyPolicyUrl": "https://www.circle.com/legal/privacy-policy",
"acceptance": {
"version": "1.0.0",
"acceptedAt": "2026-05-07T12:34:56Z"
}
}
```
***
### `circle terms accept`
Explicitly accept the Terms of Use and Privacy Policy. Use this in scripts and
AI agent workflows after the user provides explicit consent.
**Syntax**
```bash theme={null}
circle terms accept [--output json]
```
**Example**
```bash theme={null}
circle terms accept --output json
```
***
### `circle terms reset`
Clear the local acceptance record. The next command run prompts you to accept
the Terms again.
**Syntax**
```bash theme={null}
circle terms reset
```
***
## Telemetry commands
Manage CLI telemetry preferences. Telemetry collects privacy-preserving usage
data to help improve Circle CLI.
### `circle telemetry status`
Show the current telemetry preference.
**Syntax**
```bash theme={null}
circle telemetry status [options]
```
**Example**
```bash theme={null}
circle telemetry status
```
***
### `circle telemetry enable`
Enable telemetry for future commands.
**Syntax**
```bash theme={null}
circle telemetry enable
```
***
### `circle telemetry disable`
Disable telemetry for future commands.
**Syntax**
```bash theme={null}
circle telemetry disable
```
# Arc Studio
Source: https://developers.circle.com/ai/arc-studio
Build and deploy onchain apps with Circle's AI coding agent.
Arc Studio is Circle's AI coding agent for building onchain apps. Describe what
you want to build, and Arc Studio writes, previews, and deploys a working
full-stack app on [Arc](https://docs.arc.io/arc-chain) with USDC ready out of
the box. It deploys to Arc testnet, so you can ship and iterate safely.
Use Arc Studio in the browser, where a live preview, editable code, and a
terminal are built in. You can also install the Arc Studio CLI to work from the
terminal, or to delegate onchain tasks from your own AI coding agent such as
Claude Code, Codex, or Cursor.
Arc Studio documentation lives in the Arc docs:
<CardGroup>
<Card title="Arc Studio overview" icon="rocket" href="https://docs.arc.io/ai/arc-studio">
What Arc Studio can build and how to get started in the browser.
</Card>
<Card title="Arc Studio CLI" icon="terminal" href="https://docs.arc.io/ai/arc-studio-cli">
Run Arc Studio from the terminal or drive it from an AI coding agent.
</Card>
</CardGroup>
# Use Circle's MCP server in your IDE
Source: https://developers.circle.com/ai/mcp
Integrate Circle's MCP server to let your LLM or AI-assisted IDE generate and
fix code for crypto apps using Circle's offerings, including Wallets, Contracts,
CCTP, and Gateway.
<MCPSetupButtons />
<span>CLI commands</span>
<CodeGroup>
```shell Claude Code icon="https://mintcdn.com/circle-167b8d39/5X_H2DLmIxVDSWCs/images/claude-logo.png?fit=max&auto=format&n=5X_H2DLmIxVDSWCs&q=85&s=2711bd5dc795308c62570a011248ef2d" theme={null}
claude mcp add --transport http circle https://api.circle.com/v1/codegen/mcp --scope user
```
```shell Codex icon="https://mintcdn.com/circle-167b8d39/5X_H2DLmIxVDSWCs/images/open-ai-logo-1.png?fit=max&auto=format&n=5X_H2DLmIxVDSWCs&q=85&s=6a603cbffbbef93cfa078c899e8f19e8" theme={null}
codex mcp add circle --url https://api.circle.com/v1/codegen/mcp
```
</CodeGroup>
## Quick setup
Add Circle's MCP server to your client with the following details:
* **Server Name**: `circle`
* **Server URL**: `https://api.circle.com/v1/codegen/mcp`
## Installation with your IDE
Select your MCP client to view detailed setup instructions:
> **Note:** If you are using a client that is not listed here, you can still use
> the Circle MCP server by manually adding the server URL to your client's
> configuration.
<Tabs>
<Tab title="Cursor">
Download and install [Cursor](https://cursor.com) if you haven't already.
[1-Click Set Up](cursor://anysphere.cursor-deeplink/mcp/install?name=circle\&config=eyJ1cmwiOiJodHRwczovL2FwaS5jaXJjbGUuY29tL3YxL2NvZGVnZW4vbWNwIn0%3D)
Manual steps:
1. Open a project in Cursor and navigate to **Cursor Settings**.
2. In the settings menu, go to the **MCP** section.
3. Click **New MCP Server**. This will open your `mcp.json` configuration file.
4. Add the following configuration:
```json theme={null}
{
"mcpServers": {
"circle": {
"url": "https://api.circle.com/v1/codegen/mcp"
}
}
}
```
5. Return to the MCP settings page and enable the server using the toggle switch
next to `circle`. Start generating code for Circle Wallets, Contracts, CCTP,
and Gateway.
For more information on how to use MCP with Cursor, see the
[Cursor MCP documentation](https://cursor.com/docs/context/mcp).
</Tab>
<Tab title="Claude Code">
Download and install
[Claude Code](https://docs.claude.com/en/docs/claude-code/overview) if you
haven't already.
1. Using the Claude Code command line add the MCP server with the following
command:
```shell theme={null}
claude mcp add --transport http circle https://api.circle.com/v1/codegen/mcp --scope user
```
2. Verify the server is added by running the following command:
```shell theme={null}
claude mcp get circle
```
3. Start generating code for Circle Wallets, Contracts, CCTP, and Gateway.
For more information on how to use MCP with Claude Code, see the
[Claude Code MCP documentation](https://docs.claude.com/en/docs/claude-code/mcp).
</Tab>
<Tab title="Windsurf">
Download and install
[Windsurf](https://docs.windsurf.com/windsurf/getting-started) if you haven't
already.
1. Open the `~/.codeium/windsurf/mcp_config.json` file and add the following:
```json theme={null}
{
"mcpServers": {
"circle": {
"url": 프로젝트로 돌아가기
