Mercado Pago MCP

Integração com MCP Server do Mercado Pago

Actions26

Documentation Actions
- Search
Payment Actions
Order Actions
Customer Actions
Preference Actions
Webhook Actions
Notification Actions
- Get
- Process

Overview

This node integrates with the Mercado Pago MCP (Mercado Pago Checkout Pro) API to manage checkout preferences, among other resources. Specifically, for the Preference - Create operation, it allows users to create a new checkout preference by specifying an array of items that will be included in the payment checkout flow.

Common scenarios where this node is beneficial include:

E-commerce platforms wanting to generate a checkout preference dynamically based on a shopping cart.
Automating the creation of payment preferences for custom sales flows.
Integrations where you need to prepare a payment preference before redirecting customers to Mercado Pago's checkout page.

Example use case:

You have a list of products selected by a customer and want to create a checkout preference with those items so that the customer can complete the payment via Mercado Pago.

Properties

Name	Meaning
Items	JSON array representing the items to include in the checkout preference. Each item should contain fields like `title`, `quantity`, `unit_price`, and `currency_id`. Example: `[{"title": "Product", "quantity": 1, "unit_price": 100, "currency_id": "BRL"}]`

Output

The node outputs a JSON object containing the result of the preference creation request. The output includes:

type: A string indicating the type of response, e.g., "preference_created".
preference: An object with the details of the created checkout preference as returned by the Mercado Pago API.
success: Boolean indicating if the operation was successful (true).
timestamp: ISO string timestamp of when the operation was performed.

If the operation fails and "Continue On Fail" is enabled, the output will contain an error message and success flag set to false.

No binary data output is produced by this operation.

Dependencies

Requires an API key credential for Mercado Pago MCP with appropriate permissions.
Uses the Mercado Pago MCP API endpoint https://api.mercadopago.com/checkout/preferences.
Requires network access to call the Mercado Pago API.
The node expects the items property to be valid JSON parsable into an array of item objects.

Troubleshooting

Invalid JSON in Items: If the items input is not valid JSON or does not conform to the expected structure, the API call will fail. Ensure the JSON is correctly formatted and each item has required fields like title, quantity, unit_price, and currency_id.
Authentication Errors: If the API key credential is missing, invalid, or lacks permissions, the node will throw authentication errors. Verify the credential configuration.
API Endpoint Issues: Network issues or incorrect API endpoint URLs may cause failures. Confirm network connectivity and correct environment setup.
Unexpected API Response: If Mercado Pago changes their API or returns unexpected data, the node might fail or produce errors. Check the API documentation and update the node or credentials accordingly.