PluginBench
MCP Server
Active
MIT

io.github.codespar/mcp-celcoin MCP Server

io.github.codespar/mcp-celcoin

MCP server for Celcoin — Pix, boleto, transfers, bill payments, top-ups in Brazil.

What is the io.github.codespar/mcp-celcoin MCP server?

The Celcoin MCP server is a Model Context Protocol integration for Celcoin, a Brazilian fintech payment platform. It exposes 18 tools for managing Pix transfers, boleto payments, bill payments, and mobile top-ups, enabling AI agents to handle payment operations programmatically.

Celcoin is a Brazilian payment service provider offering Pix, boleto, transfers, and bill payments. This MCP server wraps Celcoin's API, allowing your AI agent to create and manage payments, process transfers, issue invoices, and handle top-ups without manual intervention. Use it when you need to automate payment workflows in Brazil or integrate Celcoin into a larger business automation system.

How to install io.github.codespar/mcp-celcoin

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • CELCOIN_CLIENT_SECRET
    required
    secret

    API key for celcoin

~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mcp-celcoin": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-celcoin"
      ],
      "env": {
        "CELCOIN_CLIENT_SECRET": "<YOUR_CELCOIN_CLIENT_SECRET>"
      }
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

  • Create Pix Transfer — Initiate a Pix payment transfer
  • Create Boleto — Generate a boleto payment slip
  • Process Bill Payment — Pay bills on behalf of customers
  • Mobile Top-up — Recharge mobile phone credits
  • List Transactions — Retrieve transaction history
  • Check Payment Status — Verify the status of a payment
  • Create Invoice — Issue an invoice for payment
  • Manage Recipients — Add and manage payment recipients

Use cases

  • Automate Pix payments and transfers for e-commerce orders
  • Generate boleto slips for invoice collection
  • Process utility bill payments on behalf of customers
  • Recharge mobile phone credits as part of customer rewards
  • Reconcile payment transactions and generate reports
  • Create invoices and track payment status in real-time

io.github.codespar/mcp-celcoin MCP server FAQ

What is the Celcoin MCP server?

It's an MCP integration for Celcoin, a Brazilian fintech platform. It provides 18 tools for Pix transfers, boleto payments, bill payments, and mobile top-ups, letting your AI agent handle payment operations programmatically.

Is it free to use?

The MCP server itself is free (MIT License). You need a Celcoin API key and account to use the service; Celcoin's pricing depends on transaction volume and payment type.

How do I install it in Claude Desktop?

Add it to ~/.config/claude/claude_desktop_config.json with the command `npx -y @codespar/mcp-celcoin` and set the CELCOIN_API_KEY environment variable with your API credentials.

What authentication is required?

You need a Celcoin API Key. Set it as the CELCOIN_API_KEY environment variable when running the server.

Can I use it with Cursor?

Yes, any MCP-compatible client can use it. Install via `npx @codespar/mcp-celcoin` and configure your API key in the client's MCP settings.

What payment methods does it support?

Celcoin supports Pix (instant transfers), boleto (bank slip), bill payments, and mobile top-ups. The server exposes tools for all of these.

README (reference)

Source of truth, from the repository.

<p align="center"> <h1 align="center">MCP Dev LATAM 🌎</h1> <p align="center"> <strong>Every commerce API your AI agent needs to run a business in Latin America.</strong><br> <em>Brazil 🇧🇷 · Mexico 🇲🇽 · Argentina 🇦🇷 · Colombia 🇨🇴 · Chile 🇨🇱 · Peru 🇵🇪 · plus 4 agentic payment protocols.</em> </p> <p align="center"> 110 MCP servers · 2,300 tools · 6 countries · MIT License </p> <p align="center"> <a href="https://codespar.dev/servers">Catalog</a> · <a href="#quick-start">Quick Start</a> · <a href="#agentic-payment-protocols">Agentic Protocols</a> · <a href="#all-servers">All Servers</a> · <a href="docs/CONTRIBUTING.md">Contribute</a> </p> <p align="center"> <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a> <img src="https://img.shields.io/badge/servers-110-green" alt="110 servers"> <img src="https://img.shields.io/badge/tools-2,300-orange" alt="2300 tools"> <img src="https://img.shields.io/badge/countries-6-blue" alt="6 countries"> <img src="https://img.shields.io/badge/MCP-compatible-purple" alt="MCP compatible"> </p> </p>

The Problem

AI agents can write code, analyze data, and chat. But they can't operate a business — collect payments, issue invoices, ship products, or notify customers. Especially not in Latin America, where every service has its own API, auth pattern, and quirks (mTLS for BACEN Pix v2, JWT-RSA for STP-SPEI, AFIP web services, contract-gated developer portals, and on).

Meanwhile, four agentic payment protocols are shipping in parallel — checkout protocols (Stripe ACP, Google UCP), authorization layers (AP2), and micropayment rails (x402) — and none of them compose cleanly with each other or with the regional rails businesses actually run on.

MCP Dev LATAM bridges both gaps. Traditional LATAM services + the new agentic payment protocols, all accessible through a single MCP interface.

The Solution

Each MCP server in this repo wraps a real provider — payments, fiscal, logistics, messaging, banking, ERP, identity, fraud, crypto, and the agentic protocols — so your agent can operate a complete business workflow.

🛒 Customer places order
  → 💳 Agent charges via Pix (Asaas / Mercado Pago / Zoop)
  → 📄 Agent issues NFe (Nuvem Fiscal / Focus NFe / NFe.io)
  → 📦 Agent generates shipping label (Melhor Envio / Skydropx)
  → 📱 Agent sends tracking via WhatsApp (Z-API / WhatsApp Cloud)
  → 📊 Agent records in ERP (Omie / Bling / Tiny)
  → 🏦 Agent reconciles balance (Stark Bank / Itaú / BTG)

Six systems. Zero human intervention. One agent.


Agentic Payment Protocols

Four servers that bridge the emerging agentic payment stack:

ProtocolServerToolsWhat it does
Google UCP@codespar/mcp-ucp20Universal Commerce Protocol — agentic shopping, cart, checkout, orders, delivery, identity. Google's full commerce stack for AI agents.
Stripe ACP@codespar/mcp-stripe-acp24Agentic Commerce Protocol — AI agent checkout, payment delegation, products, invoices. Live in ChatGPT with 1M+ Shopify merchants.
x402@codespar/mcp-x40210HTTP-native micropayments by Coinbase — when an agent hits a 402, it pays USDC on Base/Solana and retries. Pure HTTP, no checkout UI.
AP2@codespar/mcp-ap2 <sub>alpha</sub>22Google's Agent-to-Agent Payment Protocol — authorization, audit trails, scoped spend limits. 60+ partners including Visa, Mastercard, Stripe, PayPal.

The Autonomy Spectrum

Each protocol sits at a different level of agent autonomy:

 Human-in-loop ◄──────────────────────────────► Fully autonomous

  ┌─────────┐   ┌─────────┐   ┌─────────┐   ┌─────────┐
  │   ACP   │   │   UCP   │   │   AP2   │   │   x402  │
  │ Stripe  │   │ Google  │   │ Google  │   │Coinbase │
  └─────────┘   └─────────┘   └─────────┘   └─────────┘
  User confirms   Commerce     User sets      No user.
  every purchase  lifecycle    rules, agent   Machine-to-
  in-chat         managed      acts within    machine at
                  by agent     budget/scope   HTTP layer

The Convergence Stack

┌─────────────────────────────────────────────┐
│  Application Layer        ACP / UCP         │  Chat UX, product discovery
├─────────────────────────────────────────────┤
│  Authorization Layer      AP2 / Mandates    │  Spend limits, audit trails
├─────────────────────────────────────────────┤
│  Tool Layer               MCP  ◄── WE ARE  │  Standardized agent tools
├─────────────────────────────────────────────┤
│  Settlement Layer         x402 / Pix / Card │  On-chain or traditional rails
└─────────────────────────────────────────────┘

MCP Dev LATAM sits at the Tool Layer — the middleware that connects every application, authorization, and settlement protocol through one interface.

Why this matters

Agent needs to buy something
  ├── Full commerce?       → Google UCP (search → cart → checkout → delivery)
  ├── Retail checkout?     → Stripe ACP (create_checkout → complete_checkout)
  ├── API micropayment?    → x402 (pay_request → USDC $0.001 → data returned)
  ├── Agent-to-agent?      → AP2 (authorize_payment → execute_payment)
  └── LATAM merchant?      → Asaas / Mercado Pago / Conekta / Wompi / etc.

All via MCP. Same interface. One agent.

Quick Start

With Claude Desktop

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

{
  "mcpServers": {
    "stripe-acp": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-stripe-acp"],
      "env": {
        "STRIPE_API_KEY": "sk_test_..."
      }
    },
    "asaas": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-asaas"],
      "env": {
        "ASAAS_API_KEY": "your-api-key",
        "ASAAS_SANDBOX": "true"
      }
    }
  }
}

For alpha packages (contract-gated providers like Itaú, Bradesco, Santander, Caixa, BB, BTG, C6, Sicoob, Bradesco, Matera), add @alpha to the install:

npx -y @codespar/mcp-itau@alpha

With any MCP client

npx @codespar/mcp-stripe-acp        # Agentic Commerce Protocol
npx @codespar/mcp-ucp                # Google Universal Commerce Protocol
npx @codespar/mcp-x402               # HTTP micropayments (Coinbase)
npx @codespar/mcp-ap2@alpha          # Agent-to-Agent payment authorization

npx @codespar/mcp-asaas              # BR billing + Pix
npx @codespar/mcp-mercado-pago       # LATAM payments
npx @codespar/mcp-nuvem-fiscal       # NFe / NFSe
npx @codespar/mcp-melhor-envio       # Multi-carrier shipping
npx @codespar/mcp-z-api              # WhatsApp messaging
npx @codespar/mcp-omie               # ERP
npx @codespar/mcp-stark-bank         # Banking
npx @codespar/mcp-brasil-api         # CEP, CNPJ (no key needed!)

Try it now (no API key)

BrasilAPI and BCRA are public — no key required. Try it in your terminal:

npx @codespar/mcp-brasil-api

Then ask your agent: "What is the address for CEP 01001-000?" or "Look up CNPJ 00.000.000/0001-91".


The Complete Loop

This is what makes the LATAM catalog different — not individual connectors, but a complete business workflow across verticals:

StepVerticalExample providersWhat the agent does
1💳 PaymentAsaas / Mercado Pago / ZoopCreates Pix charge, splits to sellers
2📄 FiscalNuvem Fiscal / NFe.io / Focus NFeIssues NFe/NFSe when payment confirmed
3📦 LogisticsMelhor Envio / Correios / SkydropxQuotes shipping, generates label
4📱 MessagingZ-API / WhatsApp Cloud / TwilioSends tracking via customer's preferred channel
5📊 ERPOmie / Bling / Tiny / Conta AzulRecords order, updates inventory
6🏦 BankingStark Bank / Itaú / BTGReconciles balance, creates reports

To orchestrate all six steps with governance, approval workflows, and audit trails — use CodeSpar.


All Servers

Browse the full catalog at codespar.dev/servers. Each server has its own README, env-var requirements, and tool reference under packages/<category>/<slug>/.

💳 Payments (40 servers)

ServerToolsnpmAuth
Mercado Pago30@codespar/mcp-mercado-pagoAPI Key
Stripe30@codespar/mcp-stripeAPI Key
Zoop28@codespar/mcp-zoopAPI Key
Adyen25@codespar/mcp-adyenAPI Key
Asaas24@codespar/mcp-asaasAPI Key
Pagseguro24@codespar/mcp-pagseguroAPI Key
Stripe ACP24@codespar/mcp-stripe-acpAPI Key
Iugu23@codespar/mcp-iuguAPI Key
Openpay23@codespar/mcp-openpayAPI Key
AP2 <sub>alpha</sub>22@codespar/mcp-ap2API Key
Braintree22@codespar/mcp-braintreeAPI Key
Braspag22@codespar/mcp-braspagAPI Key
Cielo22@codespar/mcp-cieloAPI Key
Inter Bank22@codespar/mcp-inter-bankOAuth2
Mercado Libre22@codespar/mcp-mercado-libreAPI Key
Nubank <sub>alpha</sub>22@codespar/mcp-nubankOAuth2
Nupay22@codespar/mcp-nupayOAuth2
Pagar Me22@codespar/mcp-pagar-meAPI Key
Rapyd22@codespar/mcp-rapydAPI Key
Rede <sub>alpha</sub>22@codespar/mcp-redeAPI Key
Safrapay <sub>alpha</sub>22@codespar/mcp-safrapayOAuth2
Worldpay <sub>alpha</sub>22@codespar/mcp-worldpayAPI Key
Khipu <sub>alpha</sub>21@codespar/mcp-khipuAPI Key
Stone21@codespar/mcp-stoneAPI Key
Wise21@codespar/mcp-wiseAPI Key
Airwallex20@codespar/mcp-airwallexOAuth2
Culqi20@codespar/mcp-culqiAPI Key
Getnet20@codespar/mcp-getnetOAuth2
Izipay <sub>alpha</sub>20@codespar/mcp-izipayAPI Key
Picpay <sub>alpha</sub>20@codespar/mcp-picpayAPI Key
UCP20@codespar/mcp-ucpAPI Key
Vindi20@codespar/mcp-vindiAPI Key
Paypal19@codespar/mcp-paypalOAuth2
Transbank <sub>alpha</sub>19@codespar/mcp-transbankAPI Key
Celcoin18@codespar/mcp-celcoinAPI Key
dLocal18@codespar/mcp-dlocalAPI Key
Ebanx18@codespar/mcp-ebanxAPI Key
Efi18@codespar/mcp-efiAPI Key
Pix BCB18@codespar/mcp-pix-bcbAPI Key
Chargebee15@codespar/mcp-chargebeeAPI Key

🏦 Banking (12 servers)

ServerToolsnpmAuth
Stark Bank27@codespar/mcp-stark-bankAPI Key
Caixa <sub>alpha</sub>23@codespar/mcp-caixaOAuth2
Santander <sub>alpha</sub>23@codespar/mcp-santanderOAuth2
Bradesco <sub>alpha</sub>22@codespar/mcp-bradescoOAuth2
Itau <sub>alpha</sub>22@codespar/mcp-itauOAuth2
Matera <sub>alpha</sub>22@codespar/mcp-materaOAuth2
Dock <sub>alpha</sub>20@codespar/mcp-dockOAuth2
Open Finance18@codespar/mcp-open-financeAPI Key
C6 <sub>alpha</sub>14@codespar/mcp-c6OAuth2
Banco Do Brasil <sub>alpha</sub>13@codespar/mcp-banco-do-brasilOAuth2
Sicoob <sub>alpha</sub>13@codespar/mcp-sicoobOAuth2
BTG <sub>alpha</sub>12@codespar/mcp-btgOAuth2

📄 Fiscal (Brasil) (4 servers)

ServerToolsnpmAuth
Nuvem Fiscal24@codespar/mcp-nuvem-fiscalAPI Key
Nfe Io22@codespar/mcp-nfe-ioAPI Key
Conta Azul20@codespar/mcp-conta-azulAPI Key
Focus Nfe19@codespar/mcp-focus-nfeAPI Key

📱 Communication (8 servers)

ServerToolsnpmAuth
Z API27@codespar/mcp-z-apiAPI Key
Evolution API25@codespar/mcp-evolution-apiAPI Key
Twilio22@codespar/mcp-twilioAPI Key
Whatsapp Cloud22@codespar/mcp-whatsapp-cloudAPI Key
Sendgrid20@codespar/mcp-sendgridAPI Key
Rd Station18@codespar/mcp-rd-stationAPI Key
Take Blip18@codespar/mcp-take-blipAPI Key
Zenvia18@codespar/mcp-zenviaAPI Key

📦 E-commerce / Logistics (7 servers)

ServerToolsnpmAuth
Vtex33@codespar/mcp-vtexAPI Key
Shopify28@codespar/mcp-shopifyAPI Key
Amazon <sub>alpha</sub>24@codespar/mcp-amazonOAuth2
Shopee <sub>alpha</sub>22@codespar/mcp-shopeeAPI Key
Correios <sub>alpha</sub>21@codespar/mcp-correiosAPI Key
Melhor Envio18@codespar/mcp-melhor-envioAPI Key
SuperFrete11@codespar/mcp-superfreteAPI Key

📊 ERP / Accounting (5 servers)

ServerToolsnpmAuth
Omie30@codespar/mcp-omieAPI Key
Bling28@codespar/mcp-blingAPI Key
Xero24@codespar/mcp-xeroAPI Key
Quickbooks22@codespar/mcp-quickbooksAPI Key
Tiny21@codespar/mcp-tinyAPI Key

🪪 Identity & KYC (5 servers)

ServerToolsnpmAuth
Brasil API24@codespar/mcp-brasil-apiNo auth
Jumio20@codespar/mcp-jumioAPI Key
Onfido20@codespar/mcp-onfidoAPI Key
Persona20@codespar/mcp-personaAPI Key
Unico <sub>alpha</sub>18@codespar/mcp-unicoOAuth2

🛡️ Fraud & Risk (4 servers)

ServerToolsnpmAuth
Sift <sub>alpha</sub>20@codespar/mcp-siftAPI Key
Clearsale <sub>alpha</sub>18@codespar/mcp-clearsaleAPI Key
Konduto <sub>alpha</sub>18@codespar/mcp-kondutoAPI Key
Legiti <sub>alpha</sub>18@codespar/mcp-legitiAPI Key

🪙 Crypto / Stablecoins (9 servers)

ServerToolsnpmAuth
Circle23@codespar/mcp-circleAPI Key
Foxbit21@codespar/mcp-foxbitAPI Key
Bitso20@codespar/mcp-bitsoAPI Key
Mercado Bitcoin20@codespar/mcp-mercado-bitcoinAPI Key
Moonpay20@codespar/mcp-moonpayAPI Key
Unblockpay13@codespar/mcp-unblockpayAPI Key
Coinbase Commerce18@codespar/mcp-coinbase-commerceAPI Key
Transak <sub>alpha</sub>18@codespar/mcp-transakAPI Key
x40210@codespar/mcp-x402API Key

🇦🇷 Argentina (5 servers)

ServerToolsnpmAuth
Tienda Nube24@codespar/mcp-tienda-nubeAPI Key
Colppy <sub>alpha</sub>22@codespar/mcp-colppyAPI Key
AFIP <sub>alpha</sub>20@codespar/mcp-afipAPI Key
Andreani <sub>alpha</sub>18@codespar/mcp-andreaniAPI Key
BCRA16@codespar/mcp-bcraNo auth

🇨🇴 Colombia (5 servers)

ServerToolsnpmAuth
Siigo22@codespar/mcp-siigoAPI Key
Wompi22@codespar/mcp-wompiAPI Key
Alegra20@codespar/mcp-alegraAPI Key
Coordinadora <sub>alpha</sub>19@codespar/mcp-coordinadoraAPI Key
Nequi <sub>alpha</sub>16@codespar/mcp-nequiOAuth2

🇲🇽 Mexico (6 servers)

ServerToolsnpmAuth
Belvo24@codespar/mcp-belvoAPI Key
Skydropx23@codespar/mcp-skydropxAPI Key
Conekta21@codespar/mcp-conektaAPI Key
Bind ERP20@codespar/mcp-bind-erpAPI Key
Facturapi20@codespar/mcp-facturapiAPI Key
STP/SPEI <sub>alpha</sub>18@codespar/mcp-stp-speiAPI Key

Why MCP?

Model Context Protocol is the open standard for connecting AI agents to external tools. Instead of each agent building its own integrations, MCP provides a typed, discoverable interface that works with Claude, ChatGPT, Cursor, VS Code, and more.

AI Agent (Claude, ChatGPT, Cursor)
    ↕
MCP Server (this repo)
    ↕
LATAM API / Agentic Protocol (Stripe ACP, x402, Asaas, Mercado Pago, NFe.io, etc.)

Each MCP server in this repo:

  • Exposes typed tools with input/output schemas
  • Handles authentication (OAuth, mTLS, API keys, Basic Auth, JWT-RSA, signed requests)
  • Supports dual transport — stdio (default) and Streamable HTTP (--http flag)
  • Compatible with Claude Managed Agents via MCP Connector
  • Supports sandbox mode for safe testing
  • Returns structured JSON responses

Running in HTTP mode

Any server can run as an HTTP server for remote/cloud use:

# stdio (default — local, Claude Desktop, Cursor, Claude Code)
npx @codespar/mcp-asaas

# HTTP (remote — Managed Agents, cloud deployments)
npx @codespar/mcp-asaas --http
# or
MCP_HTTP=true npx @codespar/mcp-asaas

HTTP mode exposes /mcp (Streamable HTTP) and /health (status check).


Alpha vs stable

About a third of the catalog ships under the alpha npm dist-tag. These packages have correct tool schemas and auth flow, but the endpoint paths are best-guesses — typically because the provider's developer portal is contract-gated (BR public banks, AR central authority APIs, MX bank-transfer providers). They're flagged with TODO(verify) in source.

npm install @codespar/mcp-itau@alpha

Stable packages (the majority) install with the default tag:

npm install @codespar/mcp-stripe

Status is shown on every package page at codespar.dev/servers and in each package README.


About CodeSpar

CodeSpar builds commerce infrastructure for AI agents in Latin America — an MCP catalog (this repo), a runtime + SDK (@codespar/sdk on npm, codespar on PyPI), and a managed-tier governance product (AgentGate: programmable wallet, policy engine, CFO-grade audit, fiscal-compliance certifications).

Individual MCP servers are useful. Orchestrating many with governance is powerful. That's what CodeSpar does.


Contributing

We welcome contributions. See CONTRIBUTING.md.

Want a server for a service not listed? Open a server-request issue — there's a structured form with name, npm package, docs link, auth flow.

License

MIT — use freely in commercial and open source projects.

Related MCP servers

Brazilian KYC/KYB platform with biometrics, OCR, ICP-Brasil e-signature, and onboarding for AI agents.

267
JavaScript
MIT
View repository →

Manage Chargebee subscription billing and recurring revenue directly from your AI agent.

267
JavaScript
MIT
View repository →

MCP access to Cielo's Brazilian payment gateway: credit card, debit, boleto, and recurring charges.

267
JavaScript
MIT
View repository →

Give AI agents access to Circle's USDC wallets, payouts, and transfers via MCP.

267
JavaScript
MIT
View repository →

Fraud prevention and order risk scoring for Brazilian e-commerce, via MCP.

267
JavaScript
MIT
View repository →

MCP server for Clip (PayClip) — Mexico's leading payment acquirer with payment links, card charges, and refunds.

267
JavaScript
MIT
View repository →