Demo Mercadopago MCP Server

🚀 Mercado Pago MCP Server Demo

A Model Context Protocol (MCP) server that provides tools to help you integrate Mercado Pago into your applications.

🚀 Quick Start

📦 Installation

1. Clone the repository:

   git clone https://github.com/mercadolibre/demo-mercadopago-mcp-server.git
   cd demo-mercadopago-mcp-server
   

2. Install the dependencies:

   npm install
   

3. Obtain Mercado Pago API credentials

   You need to provide valid Mercado Pago API credentials through environment variables:

   • Get your credentials on the Mercado Pago Developers Control Panel
   • CLIENT_ID: Your Mercado Pago application ID
   • CLIENT_SECRET: Your Mercado Pago secret key

4. Configure the MCP server in your IDE

   To use it 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
         }
       }
     }
   }
   

✨ Features

search_documentation

Search in Mercado Pago's documentation.

Parameters

• language (string, required)

  • Documentation language
  • Options: "es" (Spanish), "pt" (Portuguese)

• query (string, required)

  • Term to find in the 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

<use_mcp_tool>
<server_name>mercadopago</server_name>
<tool_name>search_documentation</tool_name>
<arguments>
{
  "language": "es",
  "query": "checkout pro",
  "siteId": "MLA",
  "limit": 3
}
</arguments>
</use_mcp_tool>

Example Response:

# Search results for “checkout pro”
Showing 3 out of 8 results

## Checkout Pro
Checkout Pro is a solution that allows your customers to make payments securely...

🔗 [Learn more](https://www.mercadopago.com.ar/developers/es/guides/checkout-pro/introduction)

Score: 0.95

---

## Integrate Checkout Pro
Learn how to integrate Checkout Pro into your website to start receiving payments...

🔗 [Learn more](https://www.mercadopago.com.ar/developers/es/guides/checkout-pro/integration)

Score: 0.85

📚 Documentation

Build

Install the dependencies:

npm install

Build the server:

npm run build

Watch for changes in development mode:

npm run watch

Run

Set the environment variables to run the server and add debug information:

DEBUG=true npm start

Debug Information

• Status: mercadopago:*
• For internal use only: mercadopago:internal

💻 Usage Examples

Example Request

POST / HTTP/1.1
Content-Type: application/json

{
    "language": "es",
    "query": "checkout pro",
    "siteId": "MLA",
    "limit": 3
}

Example Response

{
    "results": [
        {
            "title": "Checkout Pro Guide",
            "url": "https://www.mercadopago.com.ar/developers/es/guides/checkout-pro/introduction",
            "score": 0.95
        },
        {
            "title": "Integrate Checkout Pro",
            "url": "https://www.mercadopago.com.ar/developers/es/guides/checkout-pro/integration",
            "score": 0.85
        }
    ]
}