Brazil Payments MCP — let AI agents accept Pix & card payments in Brazil
Use it in 60 seconds
Paste this into your MCP client config (Claude Desktop, Cursor, Windsurf, or any MCP-capable agent):
{
"mcpServers": {
"brazil-payments": {
"type": "http",
"url": "https://mcp-br.wishpool.app/mcp"
}
}
}
Nothing to install. Credentials, when you need them, travel as HTTP headers on each request and are never stored — see the threat model.
Or run it yourself
Would you rather not send production credentials to a server you do not control? Deploy this identical code to your own account and point your agent at your own URL:
git clone https://github.com/junter1989k-ai/brazil-payments-mcp && cd brazil-payments-mcp && npx vercel --prod
MIT-licensed. Self-hosting removes us from the picture entirely, at no cost and with no loss of function.
Live · MCP endpoint:
https://mcp-br.wishpool.app/mcp· Listed on the official MCP Registry asapp.wishpool/brazil-payments-mcp· Sister servers: Taiwan · Japan · Korea · Indonesia · India
A remote MCP server that lets any AI agent (Claude, ChatGPT, Cursor…) accept payments in Brazil:
- ⚡ Pix — Brazil's national instant payment rail, the way Brazil actually pays
- 💳 Credit & debit cards / boleto
- 🔍 Payment status check — pull-based, no webhook needed; no confirm step, payment completes automatically
v0.1 routes through Mercado Pago Checkout Pro, the largest payment platform in Latin America. The provider registry is built for aggregation — more Brazilian gateways join behind the same tools.
⚖️ Stateless translation layer: funds always flow buyer → Mercado Pago → merchant directly. This server never holds, moves, or stores funds or credentials — no database at all.
Quick start
MCP endpoint: https://mcp-br.wishpool.app/mcp (Streamable HTTP, stateless JSON-RPC)
| Header | Value |
|---|---|
x-mercadopago-access-token | Your Mercado Pago access token. TEST-... = test mode (no real money, free from mercadopago.com.br/developers); APP_USR-... = production. |
Tools
| Tool | What it does |
|---|---|
create_payment_link | Create a BRL checkout link (reais, decimals OK). Returns the hosted Checkout Pro URL + external_reference. |
query_payment_status | Check by external_reference: APPROVED (paid) / PENDING / IN_PROCESS / REJECTED / NO_PAYMENT_YET / …. |
Develop
node test/serve.js # local server (http://localhost:3216/mcp)
node test/e2e.js # protocol + validation suite (probes real Mercado Pago auth errors)
Zero runtime dependencies; Node ≥ 18. MIT license.
Part of a family covering Taiwan (ECPay/NewebPay + e-invoices), Japan (KOMOJU konbini/PayPay), Korea (Toss cards/KakaoPay·NaverPay), Indonesia (Midtrans GoPay/QRIS/Alfamart), India (Razorpay UPI) — and growing.