Brazil Payments (Mercado Pago — Pix / cards / boleto)

Official3 tools

by junter1989k-ai · JavaScript

Brazil payments for AI agents — Pix, cards, boleto via Mercado Pago. Never holds funds.

Brazil payments for AI agents. The MCP server enables accepting Pix, card, and boleto payments via Mercado Pago. It is described as “Never holds funds,” and it uses HTTP access to provide the integration for MCP-capable clients.

🛠️ Key Features

Supports Pix, cards, and boleto through Mercado Pago
“Never holds funds”
Uses HTTP-based MCP endpoint (https://mcp-br.wishpool.app/mcp)
Tool count: 3

🚀 Use Cases

Let AI agents accept Brazil payments (Pix, card, boleto)
Connect an MCP client (e.g., Claude Desktop, Cursor, Windsurf) to Mercado Pago payments

⚡ Developer Benefits

No installation steps (“Nothing to install”)
Credentials “travel as HTTP headers on each request” and “are never stored”

⚠️ Limitations

Credential handling depends on per-request HTTP headers; see the referenced threat model page (https://mcp.wishpool.app/trust)

Supported Topics

ai-agents, brazil, mcp, mcp-server, mercadopago, payments, pix, ai-agent, claude, wishpool

Topics

ai-agentsbrazilmcpmcp-servermercadopagopaymentspixai-agentclaudewishpool

Captured live from the server via tools/list.

create_payment_link

Create a Brazil payment link in BRL via Mercado Pago Checkout Pro, the largest payment platform in Latin America. Buyer pays with Pix (Brazil's instant payment rail), credit/debit card, or boleto — whatever is enabled on the merchant account. Returns a hosted checkout URL the buyer opens to pay — payment completes automatically, no confirm step. Amounts in BRL reais (decimals allowed, e.g. 49.90). Bring your own Mercado Pago access token via the x-mercadopago-access-token header (free TEST- tokens from mercadopago.com.br/developers; TEST- tokens never move real money). Money always flows buyer→Mercado Pago→merchant; this service never touches funds.

Parameters6

amount_brl	number	required	Amount in BRL reais (e.g. 49.90). Minimum R$1.
description	string	required	What this payment is for (shown to the buyer as the item title, ≤256 chars)
payer_email	string	optional	Optional buyer email.
success_url	string	optional	Optional https URL to send the buyer to after approved payment.
failure_url	string	optional	Optional https URL for failed payment.
external_reference	string	optional	Your unique order reference (≤64 chars). Auto-generated if omitted. Needed to query status later.

Raw schema

{
  "type": "object",
  "properties": {
    "amount_brl": {
      "type": "number",
      "minimum": 1,
      "maximum": 10000000,
      "description": "Amount in BRL reais (e.g. 49.90). Minimum R$1."
    },
    "description": {
      "type": "string",
      "description": "What this payment is for (shown to the buyer as the item title, ≤256 chars)"
    },
    "payer_email": {
      "type": "string",
      "description": "Optional buyer email."
    },
    "success_url": {
      "type": "string",
      "description": "Optional https URL to send the buyer to after approved payment."
    },
    "failure_url": {
      "type": "string",
      "description": "Optional https URL for failed payment."
    },
    "external_reference": {
      "type": "string",
      "description": "Your unique order reference (≤64 chars). Auto-generated if omitted. Needed to query status later."
    }
  },
  "required": [
    "amount_brl",
    "description"
  ]
}

query_payment_status

Check whether a Brazil payment (created by create_payment_link) has been paid. Searches Mercado Pago payments by external_reference — a reliable pull-based alternative to webhooks. paid=true when status is APPROVED. NO_PAYMENT_YET means the buyer has not attempted payment. Status values include APPROVED (paid=true — money is in), PENDING/IN_PROCESS (not paid yet, keep polling ~20s), REJECTED and CANCELLED; NO_PAYMENTS_FOUND just means the buyer has not started paying yet.

Parameters1

external_reference

string

required

The external_reference returned by create_payment_link

Raw schema

{
  "type": "object",
  "properties": {
    "external_reference": {
      "type": "string",
      "description": "The external_reference returned by create_payment_link"
    }
  },
  "required": [
    "external_reference"
  ]
}

refund_payment

Refund a paid payment (created by create_payment_link). Full refund by default; pass amount for a partial refund where supported. Refunds respect the same owner policy guardrails (x-agentpay-max-amount) as payments — the amount is checked before anything is sent to the gateway.

Parameters2

external_reference	string	required	The external_reference of the paid payment (same id used by query_payment_status)
amount	number	optional	Optional partial-refund amount in the local currency major unit. Omit for a full refund.

Raw schema

{
  "type": "object",
  "properties": {
    "external_reference": {
      "type": "string",
      "description": "The external_reference of the paid payment (same id used by query_payment_status)"
    },
    "amount": {
      "type": "number",
      "description": "Optional partial-refund amount in the local currency major unit. Omit for a full refund."
    }
  },
  "required": [
    "external_reference"
  ]
}

README.md4 KBView on GitHub

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):

json

{
  "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:

bash

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

bash

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.

Install

Tools (3)

create_payment_linkquery_payment_statusrefund_payment

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp-br.wishpool.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "brazil-payments-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp-br.wishpool.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Supported Topics

Topics

create_payment_link

query_payment_status

refund_payment

Brazil Payments MCP — let AI agents accept Pix & card payments in Brazil

Use it in 60 seconds

Or run it yourself

Quick start

Tools

Develop

Install

Remote endpoint

Related servers