Mercado Pago MCP Server

Demo Mercado Pago MCP Server

A Model Context Protocol server that provides tools for integrating Mercado Pago into your applications.

Installation & Setup

1. Clone the repository:
   git clone https://github.com/mercadolibre/demo-mercadopago-mcp-server.git cd demo-mercadopago-mcp-server
2. Install dependencies:
   npm install
3. Get Mercado Pago API credentials You'll need to provide valid Mercado Pago API credentials through the environment variables:
   • Get your credentials from Mercado Pago Developer Dashboard
   • CLIENT_ID: Your Mercado Pago application ID
   • CLIENT_SECRET: Your Mercado Pago secret key
4. Configure MCP Server in your IDE To use with Claude Desktop or other MCP-compatible applications (including Windsurf, Cursor, Cline, etc), add the server configuration to your settings:
   { "mcpServers": { "mercadopago": { "command": "node", "args": ["/path/to/demo-mercadopago-mcp-server/build/index.js"], "env": { "CLIENT_ID": "your-mercadopago-client-id", "CLIENT_SECRET": "your-mercadopago-client-secret", "DEBUG": "true" // Optional: Enable debug logging } } } }

Available Tools

search_documentation

Search through Mercado Pago's documentation.

Parameters

• language (string, required)
  • Documentation language
  • Options: "es" (Spanish), "pt" (Portuguese)
• query (string, required)
  • Search term to find in documentation
• siteId (string, required)
  • Country site identifier
  • Options: "MLB" (Brazil), "MLA" (Argentina), "MLM" (Mexico), "MLU" (Uruguay), "MLC" (Chile), "MCO" (Colombia), "MPE" (Peru)
• limit (number, optional)
  • Maximum number of results to return
  • Default: 10
  • Range: 1-100

Example Request

Example response:

Development Guide

Building

Install dependencies:

Build the server:

Watch mode for development:

Running

Configure environment variables:

Start the server:

Run with inspector for testing: