MCP Server: io.github.codespar/mcp-mercado-pago

The io.github.codespar/mcp-mercado-pago Model Context Protocol (MCP) server provides access related to Mercado Pago in Latin America, covering payments, checkout, PIX, and refunds. Its metadata lists topics for agentic commerce, AI agents, open-finance, and LLM tools, and it is distributed via npm.

🛠️ Key Features

Mercado Pago payments and checkout integration
PIX support
Refunds handling
MCP server for use with Model Context Protocol

🚀 Use Cases

Build agentic-commerce flows that interact with Mercado Pago
Automate checkout and payment-related tasks for LATAM contexts
Integrate PIX payment operations and refund workflows

⚡ Developer Benefits

Tooling aligned with model-context-protocol and mcp
Listed for developer use with llm-tools and ai-agents
Published under MIT license (per repository excerpt)

⚠️ Limitations

Server capabilities beyond payments, checkout, PIX, and refunds are not described in the provided excerpt.

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 token
export MERCADO_PAGO_ACCESS_TOKEN="APP_USR-..."

# Run via stdio
npx -y @codespar/mcp-mercado-pago

# Run via HTTP
MCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-mercado-pago

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

Variable

Required

Description

MERCADO_PAGO_ACCESS_TOKEN

Yes

Access token from Mercado Pago dashboard

MCP_HTTP

Set to "true" to enable HTTP transport

MCP_PORT

HTTP port (default: 3000)

Install

Configuration

Environment variables

MERCADO_PAGO_ACCESS_TOKENrequiredsecret

API key/token for mercado-pago

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-mercado-pago": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-mercado-pago@0.2.2"
      ],
      "env": {
        "MERCADO_PAGO_ACCESS_TOKEN": "<YOUR_MERCADO_PAGO_ACCESS_TOKEN>"
      }
    }
  }
}

io.github.codespar/mcp-mercado-pago

MCP Server: io.github.codespar/mcp-mercado-pago

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

@codespar/mcp-mercado-pago

Quick Start

Claude Desktop

Claude Code

CLI

Tools (30)

Environment Variables

Authentication

API Reference

Enterprise

License

Install

Configuration

Related servers