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 from Mercado Pago into your internal systems or workflows.

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 CRM or trigger further automation steps.

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 full response from Mercado Pago's API for the requested order. It includes comprehensive order details such as:

  • Order ID
  • Transaction amount
  • Description
  • Payment method details
  • Payer information (email, etc.)
  • Order status and timestamps
  • Any associated transactions or metadata

Additionally, the output includes metadata fields:

  • type: Indicates the type of response, here "order_retrieved".
  • success: Boolean indicating if the operation was successful.
  • timestamp: ISO string 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).
  • Requires network access to Mercado Pago's API.
  • The node expects the credential to provide an access token and environment configuration.

Troubleshooting

  • Common issues:

    • Invalid or missing order ID will cause the API call to fail.
    • Expired or invalid API credentials will result in authentication errors.
    • Network connectivity problems may cause request timeouts or failures.

  • Error messages:

    • "Order not found": The specified order ID does not exist or is incorrect. Verify the order ID.
    • "Unauthorized" or "Invalid token": Check that the API key credential is valid and has not expired.
    • "Request failed" or timeout errors: Ensure stable internet connection and that Mercado Pago API is reachable.

  • To resolve errors, verify input parameters, refresh credentials if needed, and check API status.

Links and References

Discussion