Mercado Pago MCP Server

Uses Bearer token authentication. Set this environment variable before launching the server. Its 30 documented tools cover payment, subscription, preference, methods.

People connecting finance tools to Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

One of 127 MCP servers published from codespar/mcp-dev-latam. Stars and repository activity are shared across all of them. See all 127 →

VERIFIED ACTIVE

LAST COMMIT 2026-08-12 · VERIFIED 2026-08-25

MIT · JavaScript servers · how we verify → /methodology

01 · Install Mercado Pago

before you install - you'll need

Set MERCADO_PAGO_ACCESS_TOKEN, MCP_HTTP before connecting.

Claude Code

claude mcp add codespar-mcp-dev-latam-packages-payments -- npx -y @codespar/mcp-mercado-pago

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "codespar-mcp-dev-latam-packages-payments": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-mercado-pago"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @codespar/mcp-mercado-pago - published under the repo owner's npm scope (@codespar)

registry namespace io.github.codespar is GitHub-verified and matches the repo owner

03 · What Mercado Pago can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can create a new payment, get payment details by ID, search payments with filters, and create a checkout preference for Checkout Pro.

Capability map

Tools grouped from the project's README - what Mercado Pago lets an agent do.

Payment

8 tools - e.g. Create a new payment; Get payment details by ID; List available payment methods

create_payment · get_payment · get_payment_methods · create_pix_payment · get_payment_method_details · create_advanced_payment…

create & write

6 tools - e.g. Refund a payment (full or partial); Create a customer; Tokenize a card for secure payments

create_refund · create_customer · create_card_token · create_store · create_pos · create_settlement_report

read & search

5 tools - e.g. Search payments with filters; List customers; Get account balance

search_payments · list_customers · get_balance · list_stores · get_identification_types

Subscription

4 tools - e.g. Create a recurring subscription (preapproval); Get subscription (preapproval) details by ID; Cancel a subscription (preapproval)

create_subscription · get_subscription · cancel_subscription · update_subscription

Preference

2 tools - e.g. Create a checkout preference for Checkout Pro; Get checkout preference by ID

create_preference · get_preference

Merchant

2 tools - e.g. Get merchant order by ID; Search merchant orders with filters (last 90 days).

get_merchant_order · search_merchant_orders

Chargeback

2 tools - e.g. Get chargeback details by ID; Upload documentation/evidence for a chargeback dispute.

get_chargeback · upload_chargeback_evidence

auth & access

1 tool - e.g. Exchange an authorization code for a seller access token (marketplace onboarding).

oauth_token_exchange

04 · Who maintains Mercado Pago

mcp-mercado-pago is maintained by codespar. We track 127 MCP servers from codespar - 127 actively maintained, 269 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from codespar.

05 · Facts

repository: github.com/codespar/mcp-dev-latam
category: finance - actively maintained as of 2026-08-25.
registry: io.github.codespar/mcp-mercado-pago (active, first published 2026-04-12 · 3 versions)
packages: npm:@codespar/mcp-mercado-pago

06 · Mercado Pago FAQ

Is Mercado Pago still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-12. We re-verify nightly.

What can Mercado Pago do?

With this server connected, an agent can create a new payment, get payment details by ID, search payments with filters, and create a checkout preference for Checkout Pro.

How do I install Mercado Pago?

Run `npx -y @codespar/mcp-mercado-pago`. The README documents 2 environment variables (MERCADO_PAGO_ACCESS_TOKEN, MCP_HTTP) to set first. Set MERCADO_PAGO_ACCESS_TOKEN, MCP_HTTP before connecting. You can also paste the ready-made client config above.

Does Mercado Pago run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Mercado Pago

Alternatives to Mercado Pago

Maintained finance servers if Mercado Pago isn't the fit.

Pairs well with

Servers that cover what Mercado Pago doesn't - only shown when the pairing reason fits the companion.

More finance MCP servers · Nubank · Paypal · Rinne · Stone · Stripe

More JavaScript MCP servers · Niubiz · Nupay · Openpay · Pagar Me · see all