@codespar/mcp-mercado-pago

MCP Mercado Pago

MCP server for the Mercado Pago payment gateway — the leading payment platform in Latin America.

Quick Start

# Set your access token
export MERCADO_PAGO_ACCESS_TOKEN="APP_USR-..."

# Run via stdio
npx tsx packages/payments/mercado-pago/src/index.ts

# Run via HTTP
npx tsx packages/payments/mercado-pago/src/index.ts --http

Environment Variables

Variable	Required	Description
MERCADO_PAGO_ACCESS_TOKEN	Yes	Access token from Mercado Pago dashboard
MCP_HTTP	No	Set to "true" to enable HTTP transport
MCP_PORT	No	HTTP port (default: 3000)

Tools (30)

Tool	Purpose
create_payment	Create a new payment
get_payment	Get payment details by ID
search_payments	Search payments with filters
create_refund	Refund a payment (full or partial)
create_preference	Create a checkout preference for Checkout Pro
get_preference	Get checkout preference by ID
create_customer	Create a customer
list_customers	List customers
get_payment_methods	List available payment methods
create_pix_payment	Create a PIX payment
get_merchant_order	Get merchant order by ID
get_balance	Get account balance
create_subscription	Create a recurring subscription (preapproval)
get_subscription	Get subscription (preapproval) details by ID
cancel_subscription	Cancel a subscription (preapproval)
create_card_token	Tokenize a card for secure payments
get_payment_method_details	Get details of a specific payment method by ID
create_store	Create a store (physical location or POS group)
list_stores	List stores
create_pos	Create a point of sale (POS) linked to a store
update_subscription	Update a subscription (preapproval) — amount, status, reason, card token, etc.
oauth_token_exchange	Exchange an authorization code for a seller access token (marketplace onboarding).
create_advanced_payment	Create a marketplace split payment with per-recipient disbursements (application_fee, money_release_days, c...
get_advanced_payment	Get an advanced (split) payment by ID
get_chargeback	Get chargeback details by ID
upload_chargeback_evidence	Upload documentation/evidence for a chargeback dispute.
get_identification_types	Get document/identification types available per country (CPF, CNPJ, DNI, RUT, etc.).
get_payment_methods_by_site	List available payment methods for a specific Mercado Pago site (MLB=Brazil, MLA=Argentina, MLM=Mexico, MLC...
create_settlement_report	Manually generate a settlement (account money) report for a date range.
search_merchant_orders	Search merchant orders with filters (last 90 days).

Auth

Uses Bearer token authentication. Obtain your access token from the Mercado Pago Developers dashboard.

API Reference

• Mercado Pago API Docs

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

Authentication

Set these environment variables before launching the server:

• MERCADO_PAGO_ACCESS_TOKEN (required, secret) — API key/token for mercado-pago

Issue credentials at the provider's developer portal: https://www.mercadopago.com.br/developers.

License

MIT