Open-source MCP servers for Latin American commerce — Pix, NF-e, banking, fiscal, logistics, and messaging across Brazil, Mexico, Argentina, Colombia, Chile, and Peru. MIT, on npm.
Install
npx -y @codespar/mcp-adyenADYEN_API_KEYrequired · secret — Adyen API key (generated in Customer Area → Developers → API credentials)ADYEN_MERCHANT_ACCOUNTrequired — Adyen merchant account code (appears in most request bodies)ADYEN_ENVoptional — test | live. Defaults to test.ADYEN_LIVE_URL_PREFIXoptional — Required when ADYEN_ENV=live. Your merchant-specific prefix, e.g. 1797a841fbb37ca7-AdyenDemo
MCP Dev LATAM 🌎
Every commerce API your AI agent needs to run a business in Latin America.
Brazil 🇧🇷 · Mexico 🇲🇽 · Argentina 🇦🇷 · Colombia 🇨🇴 · Chile 🇨🇱 · Peru 🇵🇪 · plus 4 agentic payment protocols.
MCP servers for LATAM commerce · live in the official MCP Registry · MIT License
Machine-readable catalog: codespar.dev/api/servers
Catalog · Quick Start · Agentic Protocols · All Servers · Contribute
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 for the emerging agentic payment stack. Only Stripe ACP reaches a live service today; the other three are deprecated (see the note under the table):
| Protocol | Server | Tools | What it does |
|---|---|---|---|
| Google UCP deprecated: no live endpoint | @codespar/mcp-ucp |
20 | Universal Commerce Protocol — agentic shopping, cart, checkout, orders, delivery, identity. |
| Stripe ACP | @codespar/mcp-stripe-acp |
24 | Agentic Commerce Protocol — AI agent checkout, payment delegation, products, invoices. |
| x402 deprecated: no live endpoint | @codespar/mcp-x402 |
10 | HTTP-native micropayments by Coinbase — when an agent hits a 402, it pays USDC on Base/Solana and retries. Pure HTTP, no checkout UI. |
| AP2 deprecated: no live endpoint | @codespar/mcp-ap2 alpha |
22 | Google's Agent-to-Agent Payment Protocol — authorization, audit trails, scoped spend limits. |
UCP, AP2 and x402 are deprecated: no live endpoint. Measured on 2026-09-27:
Server Default host What that host answered @codespar/mcp-ucpcommerce.googleapis.com(sandbox:sandbox.commerce.googleapis.com)HTTP 404 with Google's generic Error 404 (Not Found)page; the sandbox host fails the TLS handshake (certificate is for*.googleapis.com)@codespar/mcp-ap2ap2.googleapis.com(sandbox:sandbox.ap2.googleapis.com)the same generic 404 page; the sandbox host fails the TLS handshake the same way @codespar/mcp-x402api.x402.orgdoes not resolve in DNS (8.8.8.8 and 1.1.1.1) A generic 404 by itself does not prove a name has no service behind it:
translate.googleapis.com/v1, a registered service asked for a path it does not serve, answers the same page. What the claim rests on is that every path these servers call failed the same way. UCP and AP2 are open specifications, not APIs Google hosts, and x402 has no central API (each seller picks its own facilitator). The three packages are deprecated on npm and kept here for reference; they are out of the quick start and the decision tree below. Eight more servers are deprecated for the same reason (their default host does not resolve): C6, Dock, Matera, Legiti, Caf, Certta, Unico and Nubank.
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
├── Retail checkout? → Stripe ACP (create_checkout → complete_checkout)
└── 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, Sicoob), 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-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".
Pointing a server at another host
Every server reads its provider host from an environment variable, so a proxy, a mock, or an endpoint the provider moved can be used without a new release. The primary API is <PREFIX>_BASE_URL, where <PREFIX> is the one the server's credentials already use (CELCOIN_BASE_URL, STONE_BASE_URL, BB_BASE_URL). A second host gets <PREFIX>_<ROLE>_URL, for example STONE_AUTH_URL for a token endpoint or CIELO_QUERY_URL. When the variable is unset the server uses its documented default.
A weekly CI job (catalog-hosts.yml) resolves every default host in the catalog and completes a TLS handshake with it, and fails when a host does not exist. The only exceptions are deprecated servers and the few sandbox hosts listed, each with its reason, in scripts/catalog-hosts-known-dead.json; the job also fails when one of those comes back, so the list cannot go stale. Run it locally with python3 scripts/check-catalog-hosts.py (Python 3.10+).
The Complete Loop
This is what makes the LATAM catalog different — not individual connectors, but a complete business workflow across verticals:
| Step | Vertical | Example providers | What the agent does |
|---|---|---|---|
| 1 | 💳 Payment | Asaas / Mercado Pago / Zoop | Creates Pix charge, splits to sellers |
| 2 | 📄 Fiscal | Nuvem Fiscal / NFe.io / Focus NFe | Issues NFe/NFSe when payment confirmed |
| 3 | 📦 Logistics | Melhor Envio / Correios / Skydropx | Quotes shipping, generates label |
| 4 | 📱 Messaging | Z-API / WhatsApp Cloud / Twilio | Sends tracking via customer's preferred channel |
| 5 | 📊 ERP | Omie / Bling / Tiny / Conta Azul | Records order, updates inventory |
| 6 | 🏦 Banking | Stark Bank / Itaú / BTG | Reconciles 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 (46 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Rinne | 62 | @codespar/mcp-rinne |
API Key |
| Mercado Pago | 30 | @codespar/mcp-mercado-pago |
API Key |
| Stripe | 30 | @codespar/mcp-stripe |
API Key |
| Zoop | 28 | @codespar/mcp-zoop |
API Key |
| Adyen | 25 | @codespar/mcp-adyen |
API Key |
| Asaas | 24 | @codespar/mcp-asaas |
API Key |
| Pagseguro | 24 | @codespar/mcp-pagseguro |
API Key |
| Stripe ACP | 24 | @codespar/mcp-stripe-acp |
API Key |
| Iugu | 23 | @codespar/mcp-iugu |
API Key |
| Openpay | 23 | @codespar/mcp-openpay |
API Key |
| AP2 alpha deprecated: no live endpoint | 22 | @codespar/mcp-ap2 |
API Key |
| Braintree | 22 | @codespar/mcp-braintree |
API Key |
| Braspag | 22 | @codespar/mcp-braspag |
API Key |
| Cielo | 22 | @codespar/mcp-cielo |
API Key |
| Inter Bank | 22 | @codespar/mcp-inter-bank |
OAuth2 |
| Mercado Libre | 22 | @codespar/mcp-mercado-libre |
API Key |
| Nubank alpha deprecated: no live endpoint | 22 | @codespar/mcp-nubank |
OAuth2 |
| Nupay | 22 | @codespar/mcp-nupay |
OAuth2 |
| Pagar Me | 22 | @codespar/mcp-pagar-me |
API Key |
| Rapyd | 22 | @codespar/mcp-rapyd |
API Key |
| Rede alpha | 22 | @codespar/mcp-rede |
API Key |
| Safrapay alpha | 22 | @codespar/mcp-safrapay |
OAuth2 |
| Worldpay alpha | 22 | @codespar/mcp-worldpay |
API Key |
| Khipu alpha | 21 | @codespar/mcp-khipu |
API Key |
| Stone | 21 | @codespar/mcp-stone |
API Key |
| Malga | 24 | @codespar/mcp-malga |
API Key |
| Wise | 21 | @codespar/mcp-wise |
API Key |
| Airwallex | 20 | @codespar/mcp-airwallex |
OAuth2 |
| Culqi | 20 | @codespar/mcp-culqi |
API Key |
| Getnet | 20 | @codespar/mcp-getnet |
OAuth2 |
| Izipay alpha | 20 | @codespar/mcp-izipay |
API Key |
| Picpay alpha | 20 | @codespar/mcp-picpay |
API Key |
| UCP deprecated: no live endpoint | 20 | @codespar/mcp-ucp |
API Key |
| Vindi | 20 | @codespar/mcp-vindi |
API Key |
| Paypal | 19 | @codespar/mcp-paypal |
OAuth2 |
| Transbank alpha | 19 | @codespar/mcp-transbank |
API Key |
| Celcoin | 18 | @codespar/mcp-celcoin |
API Key |
| dLocal | 18 | @codespar/mcp-dlocal |
API Key |
| Ebanx | 18 | @codespar/mcp-ebanx |
API Key |
| Efi | 18 | @codespar/mcp-efi |
API Key |
| Pix BCB | 18 | @codespar/mcp-pix-bcb |
API Key |
| Chargebee | 15 | @codespar/mcp-chargebee |
API Key |
| Kushki | 10 | @codespar/mcp-kushki |
API Key |
| Flow.cl | 8 | @codespar/mcp-flow-cl |
API Key |
| Niubiz | 4 | @codespar/mcp-niubiz |
User/Password |
| PagBrasil | 3 | @codespar/mcp-pagbrasil |
API Key |
🏦 Banking (16 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Stark Bank | 27 | @codespar/mcp-stark-bank |
API Key |
| Caixa alpha | 23 | @codespar/mcp-caixa |
OAuth2 |
| Santander alpha | 23 | @codespar/mcp-santander |
OAuth2 |
| Bradesco alpha | 22 | @codespar/mcp-bradesco |
OAuth2 |
| Itau alpha | 22 | @codespar/mcp-itau |
OAuth2 |
| Matera alpha deprecated: no live endpoint | 22 | @codespar/mcp-matera |
OAuth2 |
| Dock alpha deprecated: no live endpoint | 20 | @codespar/mcp-dock |
OAuth2 |
| Open Finance | 18 | @codespar/mcp-open-finance |
API Key |
| Pluggy | 16 | @codespar/mcp-pluggy |
API Key |
| C6 alpha deprecated: no live endpoint | 14 | @codespar/mcp-c6 |
OAuth2 |
| Banco Do Brasil alpha | 13 | @codespar/mcp-banco-do-brasil |
OAuth2 |
| Sicoob alpha | 13 | @codespar/mcp-sicoob |
OAuth2 |
| BTG alpha | 12 | @codespar/mcp-btg |
OAuth2 |
| Iniciador | 9 | @codespar/mcp-iniciador |
API Key |
| Pomelo | 9 | @codespar/mcp-pomelo |
OAuth2 |
| Midaz | 5 | @codespar/mcp-midaz |
API Key (optional) |
📄 Fiscal (Brasil) (4 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Nuvem Fiscal | 24 | @codespar/mcp-nuvem-fiscal |
API Key |
| Nfe Io | 22 | @codespar/mcp-nfe-io |
API Key |
| Conta Azul | 20 | @codespar/mcp-conta-azul |
API Key |
| Focus Nfe | 19 | @codespar/mcp-focus-nfe |
API Key |
📱 Communication (8 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Z API | 27 | @codespar/mcp-z-api |
API Key |
| Evolution API | 25 | @codespar/mcp-evolution-api |
API Key |
| Twilio | 22 | @codespar/mcp-twilio |
API Key |
| Whatsapp Cloud | 22 | @codespar/mcp-whatsapp-cloud |
API Key |
| Sendgrid | 20 | @codespar/mcp-sendgrid |
API Key |
| Rd Station | 18 | @codespar/mcp-rd-station |
API Key |
| Take Blip | 18 | @codespar/mcp-take-blip |
API Key |
| Zenvia | 18 | @codespar/mcp-zenvia |
API Key |
📦 E-commerce / Logistics (7 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Vtex | 33 | @codespar/mcp-vtex |
API Key |
| Shopify | 28 | @codespar/mcp-shopify |
API Key |
| Amazon alpha | 24 | @codespar/mcp-amazon |
OAuth2 |
| Shopee alpha | 22 | @codespar/mcp-shopee |
API Key |
| Correios alpha | 21 | @codespar/mcp-correios |
API Key |
| Melhor Envio | 18 | @codespar/mcp-melhor-envio |
API Key |
| SuperFrete | 11 | @codespar/mcp-superfrete |
API Key |
📊 ERP / Accounting (5 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Omie | 30 | @codespar/mcp-omie |
API Key |
| Bling | 28 | @codespar/mcp-bling |
API Key |
| Xero | 24 | @codespar/mcp-xero |
API Key |
| Quickbooks | 22 | @codespar/mcp-quickbooks |
API Key |
| Tiny | 21 | @codespar/mcp-tiny |
API Key |
🪪 Identity & KYC (8 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Brasil API | 24 | @codespar/mcp-brasil-api |
No auth |
| Jumio | 20 | @codespar/mcp-jumio |
API Key |
| Onfido | 20 | @codespar/mcp-onfido |
API Key |
| Persona | 20 | @codespar/mcp-persona |
API Key |
| Unico alpha deprecated: no live endpoint | 18 | @codespar/mcp-unico |
OAuth2 |
| Certta deprecated: no live endpoint | 11 | @codespar/mcp-certta |
API Key |
| BigDataCorp | 10 | @codespar/mcp-bigdatacorp |
API Key |
| Caf deprecated: no live endpoint | 9 | @codespar/mcp-caf |
API Key |
🛡️ Fraud & Risk (4 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Sift alpha | 20 | @codespar/mcp-sift |
API Key |
| Clearsale alpha | 18 | @codespar/mcp-clearsale |
API Key |
| Konduto alpha | 18 | @codespar/mcp-konduto |
API Key |
| Legiti alpha deprecated: no live endpoint | 18 | @codespar/mcp-legiti |
API Key |
🪙 Crypto / Stablecoins (10 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Circle | 23 | @codespar/mcp-circle |
API Key |
| Foxbit | 21 | @codespar/mcp-foxbit |
API Key |
| Bitso | 20 | @codespar/mcp-bitso |
API Key |
| Mercado Bitcoin | 20 | @codespar/mcp-mercado-bitcoin |
API Key |
| Moonpay | 20 | @codespar/mcp-moonpay |
API Key |
| Unblockpay | 13 | @codespar/mcp-unblockpay |
API Key |
| Coinbase Commerce | 18 | @codespar/mcp-coinbase-commerce |
API Key |
| Transak alpha | 18 | @codespar/mcp-transak |
API Key |
| Coinbase CDP | 15 | @codespar/mcp-coinbase-cdp |
API Key |
| x402 deprecated: no live endpoint | 10 | @codespar/mcp-x402 |
API Key |
🇦🇷 Argentina (6 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Tienda Nube | 24 | @codespar/mcp-tienda-nube |
API Key |
| Colppy alpha | 22 | @codespar/mcp-colppy |
API Key |
| AFIP alpha | 20 | @codespar/mcp-afip |
API Key |
| Andreani alpha | 18 | @codespar/mcp-andreani |
API Key |
| BCRA | 16 | @codespar/mcp-bcra |
No auth |
| Payway | 6 | @codespar/mcp-payway |
API Key |
🇨🇴 Colombia (8 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Siigo | 22 | @codespar/mcp-siigo |
API Key |
| Wompi | 22 | @codespar/mcp-wompi |
API Key |
| Alegra | 20 | @codespar/mcp-alegra |
API Key |
| Coordinadora alpha | 19 | @codespar/mcp-coordinadora |
API Key |
| Nequi alpha | 16 | @codespar/mcp-nequi |
OAuth2 |
| Cobre | 8 | @codespar/mcp-cobre |
API Key |
| ePayco | 8 | @codespar/mcp-epayco |
API Key |
| Bold | 7 | @codespar/mcp-bold-co |
API Key |
🇲🇽 Mexico (7 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Belvo | 24 | @codespar/mcp-belvo |
API Key |
| Skydropx | 23 | @codespar/mcp-skydropx |
API Key |
| Conekta | 21 | @codespar/mcp-conekta |
API Key |
| Bind ERP | 20 | @codespar/mcp-bind-erp |
API Key |
| Facturapi | 20 | @codespar/mcp-facturapi |
API Key |
| STP/SPEI alpha | 18 | @codespar/mcp-stp-spei |
API Key |
| Clip | 6 | @codespar/mcp-clip |
API 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 (
--httpflag) - 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.
Part of a broader ecosystem index: Awesome Agentic Commerce LATAM — a vendor-neutral list of the protocols, rails, providers, and regulation for agents that move money in Latin America.
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.