Mercado Pago MCP icon

Mercado Pago MCP

Integração com MCP Server do Mercado Pago

Actions26

Overview

This node integrates with the Mercado Pago MCP (Mercado Pago's API) to manage customers, payments, orders, preferences, webhooks, notifications, and documentation searches. Specifically for the Customer - Create operation, it allows you to create a new customer record in Mercado Pago by providing essential customer details such as email, first name, and last name.

Common scenarios where this node is beneficial include:

  • Automating customer creation during onboarding processes.
  • Syncing customer data from other systems into Mercado Pago.
  • Managing customer records programmatically without manual intervention.

Practical example:

  • When a new user registers on your e-commerce platform, use this node to automatically create a corresponding customer profile in Mercado Pago to facilitate future payments or marketing activities.

Properties

Name Meaning
Email Customer's email address (required).
Primeiro Nome Customer's first name (optional).
Sobrenome Customer's last name (optional).

Output

The node outputs a JSON object containing the result of the customer creation request. The structure includes:

  • type: A string indicating the type of response, here "customer_created".
  • customer: An object with the newly created customer's details as returned by Mercado Pago.
  • success: Boolean indicating if the operation was successful (true).
  • timestamp: ISO 8601 timestamp of when the operation was performed.

Example output snippet:

{
  "type": "customer_created",
  "customer": {
    "id": "123456789",
    "email": "cliente@exemplo.com",
    "first_name": "João",
    "last_name": "Silva",
    ...
  },
  "success": true,
  "timestamp": "2024-06-01T12:00:00.000Z"
}

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 REST API endpoint https://api.mercadopago.com/v1/customers.
  • Requires network access to Mercado Pago's API servers.
  • The node expects the credential to provide an access token used in the Authorization header.

Troubleshooting

Common Issues

  • Missing required fields: The email property is mandatory. Omitting it will cause the node to fail.
  • Invalid or expired API credentials: If the access token is invalid or expired, API calls will fail with authorization errors.
  • Network connectivity problems: Failure to reach Mercado Pago API endpoints will cause timeouts or connection errors.
  • API rate limits: Excessive requests may trigger rate limiting by Mercado Pago.

Common Error Messages

  • "Card token is required for card payments" — Not applicable for customer creation but appears in payment operations; ensure correct parameters are provided for each operation.
  • HTTP 401 Unauthorized — Check that the API key credential is valid and has not expired.
  • HTTP 400 Bad Request — Usually indicates missing or malformed input data; verify all required properties are correctly set.
  • Network errors — Verify internet connectivity and firewall settings.

To resolve errors:

  • Double-check required input properties.
  • Confirm API credentials are correctly configured and active.
  • Review error messages returned by the API for specific guidance.

Links and References

Discussion