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 orders and related payment operations. Specifically, for the Order - Get operation, it retrieves detailed information about a specific order by its ID.

Common scenarios where this node is beneficial include:

  • Fetching the current status and details of an order in your e-commerce or payment system.
  • Verifying order data before processing refunds, captures, or cancellations.
  • Synchronizing order information between Mercado Pago and other systems.

Practical example:

  • After a customer places an order, you can use this node to retrieve the order details such as transaction amount, payment method, payer email, and order status to update your internal database or trigger further workflows.

Properties

Name Meaning
ID do Pedido The unique identifier of the order to retrieve. This is required to specify which order's information should be fetched. Example: "12345678"

Output

The output JSON contains the retrieved order information under the order field, along with metadata fields:

  • type: A string indicating the type of response, here "order_retrieved".
  • order: An object containing all details of the requested order as returned by Mercado Pago's API. This typically includes fields like order ID, transaction amount, payment method, payer info, status, creation date, and more.
  • success: Boolean flag indicating if the operation was successful (true).
  • timestamp: ISO 8601 timestamp of when the response was generated.

No binary data is output by this operation.

Example output structure (simplified):

{
  "type": "order_retrieved",
  "order": {
    "id": "12345678",
    "transaction_amount": 100.50,
    "description": "Payment for product X",
    "payment_method_id": "visa",
    "payer": {
      "email": "customer@example.com"
    },
    "status": "approved",
    ...
  },
  "success": true,
  "timestamp": "2024-06-01T12:00:00.000Z"
}

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/orders/{orderId} to fetch order details.
  • Requires network access to Mercado Pago's API.
  • No additional environment variables are needed beyond the configured credentials.

Troubleshooting

  • Common issues:

    • Invalid or missing order ID: The node requires a valid order ID; otherwise, the API will return an error.
    • Authentication errors: If the API key credential is invalid or expired, requests will fail.
    • Network connectivity problems may cause timeouts or failures connecting to Mercado Pago.

  • Error messages:

    • "Order not found": Indicates the specified order ID does not exist or is inaccessible. Verify the order ID.
    • "Unauthorized" or "Invalid token": Check that the API key credential is correctly configured and has necessary permissions.
    • Timeout or network errors: Ensure your server can reach Mercado Pago endpoints.

  • How to resolve:

    • Double-check the order ID input.
    • Re-authenticate or update the API key credential.
    • Confirm internet connectivity and firewall settings allow outbound HTTPS requests to Mercado Pago.

Links and References

Discussion