Ensure your device is connected to the internet and that there are no blocks preventing access to the MCP Server endpoint (https://mcp.mercadopago.com/mcp).

To access the MCP Server, you need a valid credential. Call one of our public APIs to verify your credential, for example the/v1/payment_methodsAPI.

See how it works in practice:

bash
Copiar
curl -X GET "https://api.mercadopago.com/v1/payment_methods" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

The expected outcome is:

json
Copiar
[
  {
    "id": "visa",
    "name": "Visa",
    "payment_type_id": "credit_card",
    "status": "active",
    "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/visa.gif",
    "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/visa.gif",
    "deferred_capture": "supported",
    "settings": {
      "card_number": {
        "length": 16,
        "validation": "standard"
      },
      "security_code": {
        "mode": "mandatory",
        "length": 3,
        "card_location": "back"
      }
    },
    "additional_info_needed": [
      {}
    ],
    "min_allowed_amount": 0.5,
    "max_allowed_amount": 60000,
    "accreditation_time": 2880,
    "financial_institutions": {},
    "processing_modes": "aggregator"
  }
]

If you receive a different response, your credentials may not be valid. If you need a new credential, follow our credentials documentation.

For most MCP clients (such as Cursor, Claude and Windsurf), Node.js 20 or higher is required. To check your current Node.js version, run:

bash
Copiar
node -v

The output will show the default Node.js version and it should be version 20 or higher. If you use NVM (Node Version Manager), run the following commands to check installed versions and, if necessary, install a new one:

bash
Copiar
# List installed Node.js versions
nvm list

# Install Node.js 20
nvm install 20

# Uninstall a specific version (replace XX with the version number)
nvm uninstall XX

If the issues persist, ensure your Node.js and NPM installations are up to date. Then, check your npm version with:

bash
Copiar
npm -v

For more information, check out the NPX documentation.

NPX is a package runner tool bundled with NPM (Node Package Manager) that's used to connect to Mercado Pago MCP Server.

To check if NPX is already installed, run:

bash
Copiar
npx --version

If you see a version number, the package is installed. In case you get a "command not found" error, you need to install or upgrade npm (which includes npx).

NPX is included with NPM version 5.2.0 and above. Run the following command to install or upgrade both packages (NPM and NPX):

bash
Copiar
npm install -g npm

After upgrading, verify the installation:

bash
Copiar
npx --version

If the issues persist, ensure your Node.js and NPM installations are up to date. Then, check your npm version with:

bash
Copiar
npm -v

For more information, check out the NPX documentation.

To successfully connect with our MCP Server, it is important to always have the latest available version of the client you are using.

To check this and, if necessary, update your version, follow the step-by-step instructions according to your preferred client.

If connection issues persist, try connecting to the MCP Server through your terminal:

bash
Copiar
npx -y mcp-remote@latest https://mcp.mercadopago.com/mcp --header 'Authorization:Bearer <ACCESS_TOKEN>'

The expected output should look like this:

text
Copiar
[22599] Using automatically selected callback port: 22476
[22599] Using custom headers: {"Authorization":"Bearer <ACCESS_TOKEN>"}
[22599] [22599] Connecting to remote server: https://mcp.mercadopago.com/mcp
[22599] Using transport strategy: http-first
[22599] Connected to remote server using StreamableHTTPClientTransport
[22599] Local STDIO server running
[22599] Proxy established successfully between local STDIO and remote StreamableHTTPClientTransport
[22599] Press Ctrl+C to exit

Common errors at this stage:

If you have issues connecting our MCP Server in Cursor or VS Code, try changing the authentication mode. To do this, follow the steps indicated for the client you are using.

json
Copiar
{
  "mcpServers": {
    "mercadopago-mcp-server-prod": {
      "url": "https://mcp.mercadopago.com/mcp",
      "headers": {
        "Authorization": "Bearer <ACCESS_TOKEN>"
      }
    }
  }
}