Mcp Mercado Pago

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Oct 24, 2026

Mercado Pago — payments, checkout, PIX, refunds for LATAM

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Lets an assistant create and manage Mercado Pago payments, checkout preferences, PIX charges, refunds, customers, and subscriptions.

What you can do
Wraps the Mercado Pago payments platform in about 30 tools. It can create and look up payments, issue full or partial refunds, build Checkout Pro preferences, create PIX payments, manage customers, stores and points of sale, handle recurring subscriptions, tokenize cards, and read balance, chargebacks and settlement reports. Marketplace features include split payments, OAuth token exchange and chargeback evidence upload.
When to use it
Useful when an assistant needs to work with Mercado Pago accounts in Latin America: taking or inspecting payments, issuing refunds, setting up checkout or PIX flows, managing subscriptions and customers, or handling marketplace disbursements and disputes.
Requirements
Runs locally over stdio via the npm package @codespar/mcp-mercado-pago, typically launched with npx, so Node.js is needed. A Mercado Pago access token must be supplied in the MERCADO_PAGO_ACCESS_TOKEN environment variable. Optional MCP_HTTP and MCP_PORT variables enable an HTTP transport. Network access to the Mercado Pago API is required.
Before you install
The server holds a Mercado Pago access token that can move real money and read account data, so treat MERCADO_PAGO_ACCESS_TOKEN as a high-value secret and prefer a scoped or test credential. Tools create payments, refunds, subscriptions, customers and stores, and can cancel subscriptions or upload dispute evidence, so assistant actions have financial and irreversible effects. Card tokenization and marketplace OAuth flows handle sensitive payment data.

Installation

In SourceWeft

  1. Open Mcp Mercado Pago in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-mercado-pago

MCP server for Mercado Pago, the leading payment platform in Latin America

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json
{  "mcpServers": {    "mercado-pago": {      "command": "npx",      "args": ["-y", "@codespar/mcp-mercado-pago"],      "env": {        "MERCADO_PAGO_ACCESS_TOKEN": "APP_USR-..."      }    }  }}

Claude Code

bash
claude mcp add mercado-pago -- npx @codespar/mcp-mercado-pago

CLI

bash
# Set your access tokenexport MERCADO_PAGO_ACCESS_TOKEN="APP_USR-..."
# Run via stdionpx -y @codespar/mcp-mercado-pago
# Run via HTTPMCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-mercado-pago

Tools (30)

ToolPurpose
create_paymentCreate a new payment
get_paymentGet payment details by ID
search_paymentsSearch payments with filters
create_refundRefund a payment (full or partial)
create_preferenceCreate a checkout preference for Checkout Pro
get_preferenceGet checkout preference by ID
create_customerCreate a customer
list_customersList customers
get_payment_methodsList available payment methods
create_pix_paymentCreate a PIX payment
get_merchant_orderGet merchant order by ID
get_balanceGet account balance
create_subscriptionCreate a recurring subscription (preapproval)
get_subscriptionGet subscription (preapproval) details by ID
cancel_subscriptionCancel a subscription (preapproval)
create_card_tokenTokenize a card for secure payments
get_payment_method_detailsGet details of a specific payment method by ID
create_storeCreate a store (physical location or POS group)
list_storesList stores
create_posCreate a point of sale (POS) linked to a store
update_subscriptionUpdate a subscription (preapproval): amount, status, reason, card token, etc.
oauth_token_exchangeExchange an authorization code for a seller access token (marketplace onboarding).
create_advanced_paymentCreate a marketplace split payment with per-recipient disbursements (application_fee, money_release_days, c...
get_advanced_paymentGet an advanced (split) payment by ID
get_chargebackGet chargeback details by ID
upload_chargeback_evidenceUpload documentation/evidence for a chargeback dispute.
get_identification_typesGet document/identification types available per country (CPF, CNPJ, DNI, RUT, etc.).
get_payment_methods_by_siteList available payment methods for a specific Mercado Pago site (MLB=Brazil, MLA=Argentina, MLM=Mexico, MLC...
create_settlement_reportManually generate a settlement (account money) report for a date range.
search_merchant_ordersSearch merchant orders with filters (last 90 days).

Environment Variables

VariableRequiredDescription
MERCADO_PAGO_ACCESS_TOKENYesAccess token from Mercado Pago dashboard
MCP_HTTPNoSet to "true" to enable HTTP transport
MCP_PORTNoHTTP port (default: 3000)

Authentication

Uses Bearer token authentication. Set this environment variable before launching the server:

  • MERCADO_PAGO_ACCESS_TOKEN (required, secret): access token for Mercado Pago

Issue credentials at the Mercado Pago Developers dashboard.

API Reference

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.

License

MIT

Source: packages/payments/mercado-pago/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts