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:

Deploy with Vercel

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 as app.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.