Mercado Pago MCP server
Mercado Pago — payments, checkout, PIX, refunds for LATAM
271 stars
Reviews
Write oneNobody has reviewed Mercado Pago yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Mercado Pago tools (30, 15 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
cancel_subscriptionwrite actionCancel a subscription (preapproval)
create_advanced_paymentwrite actionCreate a marketplace split payment with per-recipient disbursements (application_fee, money_release_days, collector_id per seller)
create_card_tokenwrite actionTokenize a card for secure payments
create_customerwrite actionCreate a customer
create_paymentwrite actionCreate a new payment
create_pix_paymentwrite actionCreate a PIX payment
create_poswrite actionCreate a point of sale (POS) linked to a store
create_preferencewrite actionCreate a checkout preference for Checkout Pro
create_refundwrite actionRefund a payment (full or partial)
create_settlement_reportwrite actionManually generate a settlement (account money) report for a date range. Returns 202; poll the report list endpoint to download when ready.
create_storewrite actionCreate a store (physical location or POS group)
create_subscriptionwrite actionCreate a recurring subscription (preapproval)
get_advanced_paymentGet an advanced (split) payment by ID
get_balanceGet account balance
get_chargebackGet chargeback details by ID
get_identification_typesGet document/identification types available per country (CPF, CNPJ, DNI, RUT, etc.). Use the seller's access token — response is country-scoped.
get_merchant_orderwrite actionGet merchant order by ID
get_paymentGet payment details by ID
get_payment_method_detailsGet details of a specific payment method by ID
get_payment_methodsList available payment methods
get_payment_methods_by_siteList available payment methods for a specific Mercado Pago site (MLB=Brazil, MLA=Argentina, MLM=Mexico, MLC=Chile, MCO=Colombia, MPE=Peru, MLU=Uruguay)
get_preferenceGet checkout preference by ID
get_subscriptionGet subscription (preapproval) details by ID
list_customersList customers
list_storesList stores
oauth_token_exchangeExchange an authorization code for a seller access token (marketplace onboarding). Also supports refresh_token grant.
search_merchant_ordersSearch merchant orders with filters (last 90 days). Useful for reconciliation of Checkout Pro / Bricks flows.
search_paymentsSearch payments with filters
update_subscriptionwrite actionUpdate a subscription (preapproval) — amount, status, reason, card token, etc.
upload_chargeback_evidencewrite actionUpload documentation/evidence for a chargeback dispute. Accepts one or more files as base64 content.
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- Code scan3 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 29 days ago15/15
- Maintainer identityregistry namespace matches repository owner7/10
How Mercado Pago compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 82/100
- higher than 63% of 48,255 servers
- Tools
- 30
- the typical server has 7
- Tools that change things
- 50%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 271
- more than 95% of 28,688 servers
What its tools let an agent do: 15 read · 12 create · 2 change · 1 delete
Install Mercado Pago in Claude Code, Cursor or VS Code
Runs npx -y @codespar/mcp-mercado-pago on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mcp-mercado-pago -- npx -y @codespar/mcp-mercado-pago
What the publisher says
From the Mercado Pago repository's README, as published. We do not edit it. Read it on GitHub
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:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Mercado Pago: common questions
- Is Mercado Pago MCP server safe?
- Mostly: it is graded B (82/100). Read the Mercado Pago safety report
- How do I install Mercado Pago?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Mercado Pago need an API key?
- Yes. The registry entry asks for
MERCADO_PAGO_ACCESS_TOKEN. - Is Mercado Pago maintained?
- The last commit was 67 days ago (2026-08-29). The latest release is v0.2.2.
- How does Mercado Pago compare with other MCP servers?
- safety score 82/100 (higher than 63% of 48,255 servers); tools 30 (the typical server has 7); tools that change things 50% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.