Mercado Pago

v0.2.0OAuth2

Checkout Pro, Pix, boleto, card. Marketplace split. The LatAm-wide payments gateway that actually works across borders.

30 tools1 env vars🌎 LATAMstable on npm

Install

terminal

$ npm install @codespar/mcp-mercado-pago

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json

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

After restart, your agent can call any of the 30 tools below — try create_payment first.

Environment variables · 1

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

MERCADO_PAGO_ACCESS_TOKEN

requiredsecret

API key/token for mercado-pago

Available tools · 30

Each tool is independent — your agent loads only what it needs to reduce context and response time.

WRITEcreate_payment

Create a new payment

WRITEget_payment

Get payment details by ID

WRITEsearch_payments

Search payments with filters

DELETEcreate_refund

Refund a payment (full or partial)

WRITEcreate_preference

Create a checkout preference for Checkout Pro

READget_preference

Get checkout preference by ID

WRITEcreate_customer

Create a customer

READlist_customers

List customers

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Claude Agent SDKAnthropic

OpenAI AgentsOpenAI

Vercel AI SDKVercel

LangChainLangChain

LlamaIndexLlamaIndex

CrewAICrewAI

MastraMastra

Any MCP clientProtocol

Frequently asked questions

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.