mcp-mercado-pago — Claude Code MCP server: features and setup
Connect an agent to Mercado Pago tools for payments, refunds, PIX, and subscriptions. The server needs a Mercado Pago access token to run.
claude mcp add mcp-mercado-pago -e MERCADO_PAGO_ACCESS_TOKEN=<MERCADO_PAGO_ACCESS_TOKEN> -- npx -y @codespar/mcp-mercado-pagoWhat mcp-mercado-pago does
The server exposes tools for payments, Checkout Pro preferences, PIX, customers, balances, subscriptions, and merchant orders. Agents can also issue refunds, handle chargeback evidence, and create split payments. The README lists 30 tools.
In Claude Code, it runs through npx over stdio. HTTP transport is also available by setting MCP_HTTP and MCP_PORT. Supply MERCADO_PAGO_ACCESS_TOKEN when configuring the server; without a valid token, Mercado Pago requests cannot authenticate.
What it helps with
- create a Mercado Pago payment or Checkout Pro preference
- search payments with filters and inspect their details
- issue a full or partial refund
- create a PIX payment or recurring subscription
- retrieve chargeback information
Example prompts for the agent
- Create a Mercado Pago payment for this amount and currency.
- Search payments using these filters and show their statuses.
- Issue a partial refund for this payment.
How to install mcp-mercado-pago
Platform CLI
claude mcp add mcp-mercado-pago -e MERCADO_PAGO_ACCESS_TOKEN=<MERCADO_PAGO_ACCESS_TOKEN> -- npx -y @codespar/mcp-mercado-pagoReplace <…> with your own values
Platform CLI
codex mcp add mercado-pago --env MERCADO_PAGO_ACCESS_TOKEN=<MERCADO_PAGO_ACCESS_TOKEN> -- npx -y @codespar/mcp-mercado-pagoReplace <…> with your own values
Config file
{
"mcpServers": {
"mercado-pago": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-mercado-pago"
],
"env": {
"MERCADO_PAGO_ACCESS_TOKEN": "<MERCADO_PAGO_ACCESS_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mercado-pago": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-mercado-pago"
],
"env": {
"MERCADO_PAGO_ACCESS_TOKEN": "<MERCADO_PAGO_ACCESS_TOKEN>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e MERCADO_PAGO_ACCESS_TOKEN=<MERCADO_PAGO_ACCESS_TOKEN> mercado-pago npx -y @codespar/mcp-mercado-pagoReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-mercado-pago
How do I install mcp-mercado-pago in Claude Code?
Run claude mcp add mcp-mercado-pago -e MERCADO_PAGO_ACCESS_TOKEN=<MERCADO_PAGO_ACCESS_TOKEN> -- npx -y @codespar/mcp-mercado-pago. Replace the placeholder with your Mercado Pago access token.
What does mcp-mercado-pago do?
It gives an agent access to Mercado Pago operations, including payment creation and search, refunds, PIX, subscriptions, and order lookup.
What does the server need to run?
Set MERCADO_PAGO_ACCESS_TOKEN to an access token from Mercado Pago. The server uses stdio, or HTTP when MCP_HTTP=true is set.
