convez.ai
MCP ServerFinanceiroAvançado
kinance

Circle Agent Stack MCP

kinance/circle-agent-stack-mcp

Gerenciamento de carteiras e pagamentos USDC via MCP para agentes IA

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server que integra Circle Agent Stack para gerenciamento de carteiras, transferências USDC e nanopagamentos x402 via chamadas de ferramentas. Permite criar wallets, definir políticas de gasto e pagar endpoints com preço x402 diretamente do Claude.

Instalação

$npx convez-ai kinance/circle-agent-stack-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
v0.1.3
Issues abertas
0
Contribuidores
1

Casos de uso

  • Criar e gerenciar wallets de agentes com políticas de gasto automático
  • Executar transferências USDC entre endereços on-chain via Claude
  • Pagar endpoints com preço x402 como parte de fluxos de agentes IA
  • Implementar nanopagamentos para APIs pagas em criptmoedas

Veredito

Ferramenta especializada e bem arquitetada para integrar pagamentos em USDC direto em agentes Claude. Requer conhecimento de criptografia e Circle API, mas oferece abstração limpa via MCP. Útil para aplicações fintech que precisam de transações autônomas.

README

A tradução para o português deste README ainda está na fila.

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.

npx circle-agent-stack-mcp

Tools

ToolWhat it does
circle_wallet_createCreate an agent wallet (dev/hosted/smart)
circle_wallet_listList wallets with USDC balances
circle_balanceBalance + last 10 txns for a wallet
circle_policy_setSet daily cap, x402 cap, allow/block lists
circle_transfer_usdcSend USDC to an on-chain address
circle_x402_payPay an x402-priced endpoint and return its response

Quickstart

You need the Circle CLI installed and authenticated:

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

Claude Desktop

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

Claude Code

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

Example

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.

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

Related

Ver o original no GitHub

Bom para

Relacionados