Can I use this server without the Circle CLI?

No, currently it shells out to the Circle CLI for all operations to avoid reimplementing the API client.

What is the x402 pay feature?

It allows paying x402-priced endpoints in USDC and returns the endpoint's response, enabling pay-per-call usage.

Is it safe to expose this server publicly?

You should set spend caps, use dev wallets initially, review allowlists, and never commit your CIRCLE_API_KEY.

Does it support multi-chain or other stablecoins?

Multi-chain support and other stablecoins like EURC are planned for future releases.

Circle Agent Stack MCP

financestablecoincircleusdcpayments

MCP server wrapping Circle CLI to create wallets, manage USDC spend policies, transfer funds, and pay x402 endpoints.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "kinance-circle-agent-stack-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "circle-agent-stack-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

This MCP server exposes tools from Circle's Agent Stack via the Circle CLI, enabling AI agents to create USDC wallets, set spending policies, check balances, send USDC, and pay x402-priced endpoints. It is suitable for integrating Circle stablecoin operations into AI workflows without handling authentication directly in the server. The server currently shells out to the Circle CLI but plans to support direct HTTP API calls in future versions.

Use cases

Create and manage USDC wallets for AI agents

Set daily and x402 spend caps with allow/block lists

Retrieve wallet balances and recent transactions

Send USDC to on-chain addresses

Pay x402-priced endpoints and receive their responses

Key features

Create dev, hosted, or smart agent wallets

List wallets with USDC balances

View wallet balance and last 10 transactions

Set spend policies including daily and x402 caps

Send USDC transfers on-chain

Pay x402 endpoints with spend limits

Capabilities & Tool Schemas (6)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Circle Agent Stack MCP.

circle_wallet_create

Create an agent wallet (dev/hosted/smart)

circle_wallet_list

List wallets with USDC balances

circle_balance

Balance + last 10 txns for a wallet

circle_policy_set

Set daily cap, x402 cap, allow/block lists

circle_transfer_usdc

Send USDC to an on-chain address

circle_x402_pay

Pay an x402-priced endpoint and return its response

Documentation Overview

circle-agent-stack-mcp

MCP server for Circle's Agent Stack. Create wallets, set spend policies, send USDC, and pay x402-priced endpoints — all from a tool call.

Terminal

npx circle-agent-stack-mcp

Tools

Tool	What it does
`circle_wallet_create`	Create an agent wallet (dev/hosted/smart)
`circle_wallet_list`	List wallets with USDC balances
`circle_balance`	Balance + last 10 txns for a wallet
`circle_policy_set`	Set daily cap, x402 cap, allow/block lists
`circle_transfer_usdc`	Send USDC to an on-chain address
`circle_x402_pay`	Pay an x402-priced endpoint and return its response

Quickstart

You need the Circle CLI installed and authenticated:

Terminal

npm install -g @circle-fin/circle-cli
circle login
export CIRCLE_API_KEY=your_key_here

Claude Desktop

config.json

{
  "mcpServers": {
    "circle": {
      "command": "npx",
      "args": ["-y", "circle-agent-stack-mcp"],
      "env": {
        "CIRCLE_API_KEY": "your_key_here"
      }
    }
  }
}

Claude Code

Terminal

claude mcp add circle -- npx -y circle-agent-stack-mcp

Example

Code

You: Create a dev wallet called eva-treasury, set a $5 daily cap and $0.10 x402 cap,
     then fetch today's BTC signal from the x402 endpoint at https://signals.example.co/btc

Claude:
→ circle_wallet_create("eva-treasury", type="dev")
  { wallet_id: "wal_abc123", address: "0x..." }

→ circle_policy_set("wal_abc123", daily_cap_usdc=5, x402_cap_usdc=0.10)
  { status: "applied" }

→ circle_x402_pay("wal_abc123", "https://signals.example.co/btc", max_price_usdc=0.10)
  { signal: "LONG", confidence: 0.72, price_paid_usdc: 0.05 }

Today's BTC signal: LONG (72% confidence). Paid $0.05.

Self-hosting with x402 paywall

http-server.ts wraps the same tools behind an x402 paywall — agents pay per call in USDC rather than using an API key. Useful if you want to expose Circle tooling as a paid service.

bash

CIRCLE_PAYOUT_ADDRESS=0x... npm run start:http

To test the x402 flow locally, run the toy demo server in examples/x402-demo-server.mjs.

How it works

v0.1 shells out to the Circle CLI for all operations. This keeps auth handling out of this repo and avoids reimplementing the API client before the tool surface is validated. v0.2 will switch to direct HTTP via @circle-fin/circle-sdk.

Security

Your Circle API key has spend authority. Always:

Set daily_cap_usdc before enabling automated payments
Start on type="dev" wallets, not mainnet
Review the allowlist before moving to production
Don't commit CIRCLE_API_KEY

Roadmap

circle_nanopayment_stream — streaming x402 payments for per-token billing
circle_skills_list / circle_skills_call — Circle Skills marketplace
Direct HTTP API mode (v0.2) — remove CLI dependency
Multi-chain — EURC, CCTP cross-chain transfers

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

182

Package downloads in the last 30 days.

Last commit

3mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Circle Agent Stack MCP

It requires the Circle CLI to be installed and authenticated separately using CIRCLE_API_KEY environment variable.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Circle Agent Stack MCP AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/kinance-circle-agent-stack-mcp?style=directory)](https://allmcps.com/mcp/kinance-circle-agent-stack-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/kinance-circle-agent-stack-mcp"><img src="https://allmcps.com/api/badge/kinance-circle-agent-stack-mcp?style=directory" alt="Circle Agent Stack MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

PricingBring your own API key (usage-based cost)

11/11 checks healthy over the last 33d

56Quality signal: Good · 56/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools28/30

Adoption & activity4/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 23d ago via OSV.dev · circle-agent-stack-mcp (npm)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to Circle Agent Stack MCP →Install in Claude Desktop Install in Cursor Install in VS Code

Circle Agent Stack MCP

financestablecoincircleusdcpayments

MCP server wrapping Circle CLI to create wallets, manage USDC spend policies, transfer funds, and pay x402 endpoints.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "kinance-circle-agent-stack-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "circle-agent-stack-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

Use cases

Create and manage USDC wallets for AI agents

Set daily and x402 spend caps with allow/block lists

Retrieve wallet balances and recent transactions

Send USDC to on-chain addresses

Pay x402-priced endpoints and receive their responses

Key features

Create dev, hosted, or smart agent wallets

List wallets with USDC balances

View wallet balance and last 10 transactions

Set spend policies including daily and x402 caps

Send USDC transfers on-chain

Pay x402 endpoints with spend limits

Capabilities & Tool Schemas (6)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Circle Agent Stack MCP.

circle_wallet_create

Create an agent wallet (dev/hosted/smart)

circle_wallet_list

List wallets with USDC balances

circle_balance

Balance + last 10 txns for a wallet

circle_policy_set

Set daily cap, x402 cap, allow/block lists

circle_transfer_usdc

Send USDC to an on-chain address

circle_x402_pay

Pay an x402-priced endpoint and return its response

Documentation Overview

circle-agent-stack-mcp

MCP server for Circle's Agent Stack. Create wallets, set spend policies, send USDC, and pay x402-priced endpoints — all from a tool call.

Terminal

npx circle-agent-stack-mcp

Tools

Tool	What it does
`circle_wallet_create`	Create an agent wallet (dev/hosted/smart)
`circle_wallet_list`	List wallets with USDC balances
`circle_balance`	Balance + last 10 txns for a wallet
`circle_policy_set`	Set daily cap, x402 cap, allow/block lists
`circle_transfer_usdc`	Send USDC to an on-chain address
`circle_x402_pay`	Pay an x402-priced endpoint and return its response

Quickstart

You need the Circle CLI installed and authenticated:

Terminal

npm install -g @circle-fin/circle-cli
circle login
export CIRCLE_API_KEY=your_key_here

Claude Desktop

config.json

{
  "mcpServers": {
    "circle": {
      "command": "npx",
      "args": ["-y", "circle-agent-stack-mcp"],
      "env": {
        "CIRCLE_API_KEY": "your_key_here"
      }
    }
  }
}

Claude Code

Terminal

claude mcp add circle -- npx -y circle-agent-stack-mcp

Example

Code

You: Create a dev wallet called eva-treasury, set a $5 daily cap and $0.10 x402 cap,
     then fetch today's BTC signal from the x402 endpoint at https://signals.example.co/btc

Claude:
→ circle_wallet_create("eva-treasury", type="dev")
  { wallet_id: "wal_abc123", address: "0x..." }

→ circle_policy_set("wal_abc123", daily_cap_usdc=5, x402_cap_usdc=0.10)
  { status: "applied" }

→ circle_x402_pay("wal_abc123", "https://signals.example.co/btc", max_price_usdc=0.10)
  { signal: "LONG", confidence: 0.72, price_paid_usdc: 0.05 }

Today's BTC signal: LONG (72% confidence). Paid $0.05.

Self-hosting with x402 paywall

http-server.ts wraps the same tools behind an x402 paywall — agents pay per call in USDC rather than using an API key. Useful if you want to expose Circle tooling as a paid service.

bash

CIRCLE_PAYOUT_ADDRESS=0x... npm run start:http

To test the x402 flow locally, run the toy demo server in examples/x402-demo-server.mjs.

How it works

Security

Your Circle API key has spend authority. Always:

Set daily_cap_usdc before enabling automated payments
Start on type="dev" wallets, not mainnet
Review the allowlist before moving to production
Don't commit CIRCLE_API_KEY

Roadmap

circle_nanopayment_stream — streaming x402 payments for per-token billing
circle_skills_list / circle_skills_call — Circle Skills marketplace
Direct HTTP API mode (v0.2) — remove CLI dependency
Multi-chain — EURC, CCTP cross-chain transfers

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

182

Package downloads in the last 30 days.

Last commit

3mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Circle Agent Stack MCP

It requires the Circle CLI to be installed and authenticated separately using CIRCLE_API_KEY environment variable.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/kinance-circle-agent-stack-mcp?style=directory)](https://allmcps.com/mcp/kinance-circle-agent-stack-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/kinance-circle-agent-stack-mcp"><img src="https://allmcps.com/api/badge/kinance-circle-agent-stack-mcp?style=directory" alt="Circle Agent Stack MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

PricingBring your own API key (usage-based cost)

11/11 checks healthy over the last 33d

56Quality signal: Good · 56/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools28/30

Adoption & activity4/15

Community engagement0/10

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 23d ago via OSV.dev · circle-agent-stack-mcp (npm)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to Circle Agent Stack MCP →Install in Claude Desktop Install in Cursor Install in VS Code