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 Server to manage and search payments. Specifically, the Payment - Search operation allows users to either:

  • Retrieve a specific payment by its unique ID.
  • Search for multiple payments using various filters such as date ranges, status, external references, and sorting criteria.

This functionality is useful in scenarios where you need to audit transactions, reconcile payments, or generate reports based on payment data from Mercado Pago.

Practical examples:

  • Fetching details of a single payment by its ID to verify transaction status.
  • Listing all payments made within the last 30 days, filtered by approved status and sorted by approval date.
  • Searching payments linked to a specific external reference (e.g., an order number) to track related transactions.

Properties

Name Meaning
Tipo de Busca Choose how to search payments:
- Buscar Todos os Pagamentos: Search all payments with optional filters.
- Buscar por ID Específico: Search a specific payment by its ID.
ID do Pagamento The specific payment ID to search for (required if "Buscar por ID Específico" is selected).
Ordenar Por Parameter used to sort the list of payments:
- Data de Criação (Creation Date)
- Data de Aprovação (Approval Date)
- Data da Última Atualização (Last Update Date)
- ID
- Data de Liberação do Dinheiro (Money Release Date)
Critério de Ordenação Sorting order criteria:
- Crescente (Ascending)
- Decrescente (Descending)
Referência Externa External reference string to filter payments (e.g., an order identifier).
Data de Início Start date/time for the search interval. Supports relative formats like NOW-30DAYS or ISO timestamps.
Data de Fim End date/time for the search interval. Supports relative formats like NOW or ISO timestamps.
Intervalo Parameter defining which date field to use for the search interval:
- Data de Criação
- Data de Aprovação
- Data da Última Atualização
- Data de Liberação do Dinheiro
Status do Pagamento Filter payments by one or more statuses:
- Pendente (Pending)
- Aprovado (Approved)
- Autorizado (Authorized)
- Em Processo (In Process)
- Em Mediação (In Mediation)
- Rejeitado (Rejected)
- Cancelado (Cancelled)
- Reembolsado (Refunded)
- Estornado (Charged Back)

Output

The output JSON structure varies depending on the search type:

  • Search by ID (by_id):

    {
  "type": "payment_by_id",
  "payment": { /* detailed payment object from Mercado Pago API */ },
  "search_type": "by_id",
  "payment_id": "1234567890"
}

    Contains detailed information about the specific payment retrieved.

  • Search all payments (all):

    {
  "type": "payments_search",
  "payments": { /* paginated list of payments matching filters */ },
  "search_type": "all",
  "query_params": {
    "sort": "date_created",
    "criteria": "desc",
    "external_reference": "PEDIDO_123",
    "range": "date_created",
    "begin_date": "NOW-30DAYS",
    "end_date": "NOW"
  }
}

    Contains a list of payments matching the applied filters and sorting options.

Each output also includes:

  • success: boolean indicating if the operation was successful.
  • timestamp: ISO timestamp of when the response was generated.

The node does not output binary data for this operation.

Dependencies

  • Requires an API authentication token credential for Mercado Pago MCP API access.
  • Uses the Mercado Pago REST API endpoints under https://api.mercadopago.com.
  • Requires proper configuration of the credential with valid access tokens and environment settings.

Troubleshooting

  • Missing or invalid payment ID: When searching by ID, ensure the payment ID is provided and correctly formatted; otherwise, the API will return an error.
  • Invalid date formats: The beginDate and endDate fields accept relative strings like NOW-30DAYS or ISO 8601 timestamps. Incorrect formats may cause the API to reject the request.
  • Empty results: If no payments match the filters, the returned list will be empty. Verify filter parameters such as status, date range, and external reference.
  • API authentication errors: Ensure the API token credential is valid and has sufficient permissions.
  • Rate limiting or network issues: The Mercado Pago API may throttle requests or experience downtime; handle errors gracefully and consider retry logic.

Links and References

Discussion