Mcp Circle

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Oct 24, 2026

MCP server for Circle — USDC payments, wallets, payouts, transfers

The publisher's own server: Circle

VerifiedSTDIODesktop onlyFinance Business & Commerce

Server details

Identifier: io.github.codespar/mcp-circle
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account codespar for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.codespar%2Fmcp-circle.svg)](https://sourceweft.com/mcp/io.github.codespar%2Fmcp-circle?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

A local MCP server for Circle that lets an assistant manage USDC wallets, payments, payouts, transfers, cards and account balances.

What you can do: Create, list and look up Circle business-account wallets and their balances and transactions. Accept USDC payments and retrieve payment details. Create and list payouts from USDC to fiat. Create and list USDC transfers between wallets or to a blockchain address. Register and list cards, settlements and chargebacks. Create, list and delete webhook notification subscriptions.
When to use it: Useful when you want an assistant to work with Circle stablecoin operations — checking balances, moving USDC between wallets, initiating payouts or reviewing payments and chargebacks — without leaving the chat. Test against the Circle sandbox first.
Requirements: Runs locally via npx from the npm package @codespar/mcp-circle (Node.js needed). Requires a Circle developer account and a Circle API key supplied in the CIRCLE_API_KEY environment variable; the README recommends a sandbox key for testing. Network access to the Circle API is needed.

Before you install

The server handles real money: tools can create payments, payouts and transfers, which move funds, and can create or delete webhook subscriptions. The CIRCLE_API_KEY grants access to the Circle account and must be kept secret. Card registration sends card data to Circle. Start with a sandbox key and restricted balances before using live credentials.

Installation

In SourceWeft

Open Mcp Circle in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-circle

MCP server for Circle — USDC stablecoin payments, payouts, transfers, and wallets

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json

{  "mcpServers": {    "circle": {      "command": "npx",      "args": ["-y", "@codespar/mcp-circle"],      "env": {        "CIRCLE_API_KEY": "your-key"      }    }  }}

{  "mcpServers": {    "circle": {      "command": "npx",      "args": ["-y", "@codespar/mcp-circle"],      "env": {        "CIRCLE_API_KEY": "your-key"      }    }  }}

Claude Code

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json

{  "servers": {    "circle": {      "command": "npx",      "args": ["-y", "@codespar/mcp-circle"],      "env": {        "CIRCLE_API_KEY": "your-key"      }    }  }}

{  "servers": {    "circle": {      "command": "npx",      "args": ["-y", "@codespar/mcp-circle"],      "env": {        "CIRCLE_API_KEY": "your-key"      }    }  }}

Tools (23)

Tool	Purpose
`create_wallet`	Create a new Circle business-account wallet
`get_wallet`	Get wallet details by ID
`list_wallets`	List all Circle wallets
`create_payment`	Accept a USDC payment via Circle
`get_payment`	Get payment details by ID
`create_payout`	Create a payout from Circle (USDC to fiat)
`get_payout`	Get payout details by ID
`list_payouts`	List payouts with optional filters
`create_transfer`	Create a USDC transfer between Circle wallets (or to blockchain address)
`get_transfer`	Get transfer details by ID
`list_transfers`	List transfers with optional filters
`create_card`	Register card data for on-ramp payments
`get_card`	Get card details by ID
`list_cards`	List registered cards
`list_settlements`	List settlements (card payment batches)
`get_settlement`	Get settlement details by ID
`list_chargebacks`	List chargebacks
`get_chargeback`	Get chargeback details by ID
`create_subscription`	Register a notification subscription (webhook)
`list_subscriptions`	List notification subscriptions (webhooks)
`delete_subscription`	Delete a notification subscription
`get_balance`	Get business-account balance
`list_transactions`	List transactions with optional filters

Authentication

Circle uses a Bearer API key for authentication.

Sandbox / Testing

Circle provides a sandbox at api-sandbox.circle.com. Use a sandbox API key for testing.

Get your credentials

Go to Circle Developer Portal
Create a developer account
Generate a sandbox API key
Set the CIRCLE_API_KEY environment variable

Environment Variables

Roadmap

v0.2 (planned)

create_card_payment — Create a card payment
create_wire_payment — Create a wire transfer payment
create_ach_payment — Create an ACH payment
get_settlement — Get settlement details
list_settlements — List settlements with filters

v0.3 (planned)

smart_contract_calls — Execute smart contract calls
cross_chain_transfers — Transfer assets across blockchains

Want to contribute? Open a PR or request a tool.

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

Source: packages/crypto/circle/README.md at commit d0a519a

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

Other Circle integrations

Circle

so.circleOfficial publisher

A remote MCP server that lets an assistant manage a Circle community: members, website, discussions, events, courses and payments.

Streamable HTTPWeb executableAuth

Business & CommerceCredential requiredOct 24, 2026

Circle Agent Stack Mcp

Published by GitHub account kinance

A local MCP server that lets an assistant create Circle USDC wallets, set spend policies, send USDC transfers and pay x402-priced endpoints.

STDIODesktop only

FinanceNot validated yetOct 24, 2026