Demo Mercado Pago

This MCP server provides a Model Context Protocol interface to help you integrate Mercado Pago into your applications. It exposes a set of tools you can invoke from MCP clients to perform common Mercado Pago-related actions and data lookups in a consistent, scalable way.

How to use

You run the Mercado Pago MCP server locally or in your development environment and connect an MCP client to it. Use the client to call the available tools to search Mercado Pago documentation, retrieve guidance, and perform common actions related to Mercado Pago integrations. The server handles authentication via your Mercado Pago API credentials and executes the requested tool workflows, returning results you can display in your application or use to drive your integration roadmap.

How to install

# Prerequisites
- Node.js installed on your system (npm is included with Node)
- An MCP-compatible client to connect to the server

# Step 1: Clone the project
 git clone https://github.com/mercadolibre/demo-mercadopago-mcp-server.git
 cd demo-mercadopago-mcp-server

# Step 2: Install dependencies
 npm install

# Step 3: Set Mercado Pago API credentials in your environment
 # Required: CLIENT_ID and CLIENT_SECRET
 export CLIENT_ID=your_mercadolopago_client_id
 export CLIENT_SECRET=your_mercadopago_client_secret

# Optional: Enable debug logging
 export DEBUG=true

# Step 4: Run the server
 npm start

Configuration and usage notes

To run the server in an MCP-compatible IDE or tool, configure the MCP server entry so the client can launch the server process and pass the required environment variables. The following configuration shows how to start the server as a local process with Node and point it at the built entry, including credentials and an optional debug flag.

{
  "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 and what they do

The server exposes a set of MCP tools to help you work with Mercado Pago documentation and capabilities. One example is a search tool that queries Mercado Pago’s documentation in different languages and sites.

Available tools

search_documentation

Search Mercado Pago's documentation. Supports language, query, siteId, and optional limit to control results.