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.

Typical use cases include:

  • Adding new customers to your Mercado Pago account automatically when they register on your platform.
  • Synchronizing customer data between your system and Mercado Pago for payment processing or marketing purposes.
  • Automating customer creation workflows in e-commerce or subscription services.

Example: When a user signs up on your website, this node can create a corresponding customer profile in Mercado Pago using their email and optionally their first and last names.

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 operation type, 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 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.
  • The node expects the credential to provide an access token used in the Authorization header.

Troubleshooting

  • Missing required fields: If the email is not provided, the node will throw an error because it is mandatory.
  • Invalid or expired API token: Authentication errors may occur if the API key or token is invalid or expired. Ensure the credential is correctly configured and active.
  • Network issues: Timeouts or connectivity problems can cause failures. Verify network access to Mercado Pago endpoints.
  • API rate limits: Frequent requests might hit rate limits imposed by Mercado Pago, resulting in errors. Implement retries or backoff strategies if needed.
  • Unexpected API response: If Mercado Pago changes their API or returns unexpected data, the node might fail. Check the API status and update the node accordingly.

Common error messages:

  • "Card token is required for card payments" — Not applicable for customer creation but appears in other operations.
  • HTTP 401 Unauthorized — Check API credentials.
  • HTTP 400 Bad Request — Likely due to missing or invalid input parameters.

Links and References

Discussion