Brazil Payments Mcp

What is Brazil Payments Mcp?

Brazil Payments Mcp is a remote MCP server that lets AI agents (Claude, ChatGPT, Cursor, etc.) accept payments in Brazil via Pix, credit/debit cards, and boleto. It routes through Mercado Pago Checkout Pro — the largest payment platform in Latin America — and is listed on the official MCP Registry as app.wishpool/brazil-payments-mcp. The server is stateless: it never holds, moves, or stores funds or credentials, and has no database.

How to use Brazil Payments Mcp?

Use the MCP endpoint https://mcp-br.wishpool.app/mcp with the header x-mercadopago-access-token set to your Mercado Pago access token (TEST-... for sandbox, APP_USR-... for production). The server exposes two tools: create_payment_link (creates a BRL checkout link and returns the Checkout Pro URL plus external_reference) and query_payment_status (checks payment status by external_reference). No webhook or confirm step is required.

Key features of Brazil Payments Mcp

• Accept Pix, credit/debit cards, and boleto payments
• Pull-based payment status checking with no webhooks
• Stateless translation layer — never holds funds or credentials
• Zero runtime dependencies; requires Node.js ≥ 18
• MIT licensed and part of a multi-country payment MCP family

Use cases of Brazil Payments Mcp

• AI-powered customer service agents processing Pix payments in real time
• Automated invoicing and billing through chatbot interfaces
• E-commerce checkout links generated by AI assistants for Brazilian customers
• Payment status monitoring for orders without callback infrastructure

FAQ from Brazil Payments Mcp

What payment methods are supported?

Pix (Brazil’s instant payment rail), credit/debit cards, and boleto, all routed through Mercado Pago Checkout Pro.

Does Brazil Payments Mcp store or handle funds?

No. It is a stateless translation layer — funds flow directly from buyer to Mercado Pago to merchant. The server never holds, moves, or stores funds or sensitive credentials.

How do I test payments?

Use a Mercado Pago test access token (starting with TEST-...) in the x-mercadopago-access-token header. Test mode does not process real money and is free via the Mercado Pago developer portal.

What are the runtime requirements?

Node.js ≥ 18 and zero runtime dependencies. The server runs as a remote MCP endpoint; local development requires node test/serve.js.

How do I authenticate with the server?

Set the x-mercadopago-access-token HTTP header on every request. Use a TEST-... token for sandbox or APP_USR-... for production.