Tools disponíveis do MCP server
O Mercado Pago MCP Server oferece a seguinte lista de tools.
| Tool | Descrição | Parâmetros | Prompt sugerido |
search-documentation | Realiza buscas de código ou texto na documentação do Mercado Pago Developers. | -query (string, required): Termo a buscar. - language (string, required, enum): Idioma no qual a busca é realizada. Os valores permitidos são 'es' (español), 'en' (english), 'pt' (português). | Busque na documentação do Mercado Pago {query}. |
quality_checklist | Obtém uma lista detalhada dos campos avaliados pelo Mercado Pago para otimizar a qualidade da sua integração. Além disso, fornece recomendações de boas práticas para melhorar a qualidade da sua implementação durante o estágio de desenvolvimento, garantindo uma saída para produção adequada aos padrões necessários. | N/A | Obtenha a lista de campos que minha integração deve cumprir para aprovar os padrões de qualidade do Mercado Pago. Formate a saída em duas tabelas, a primeira com os campos obrigatórios e a segunda com melhorias opcionais ou boas práticas, se houver. |
quality_evaluation | A partir de um identificador de pagamento produtivo, mede a qualidade da sua integração, avaliando seu correto funcionamento e adequação aos padrões do Mercado Pago. | -payment_id (number, required): Identificador do pagamento que servirá para realizar a medição de qualidade. | Avalie a qualidade da minha integração usando o {payment_id}. Se necessário, proponha melhorias para alcançar a melhor pontuação possível. |
save_webhook | Configura ou atualiza as configurações de notificações Webhooks para receber alertas do Mercado Pago sobre as transações associadas a uma aplicação, incluindo tópicos de notificação e URLs de produção e de teste. | -callback (string, optional): URL de produção para a qual as notificações Webhook serão enviadas. - callback_sandbox (string, optional): URL de teste para a qual as notificações Webhook serão enviadas. - topics (array, string, optional): Lista de tópicos que se deseja configurar para receber notificações. Se não for enviado, será considerado o tópico payment por padrão. | Configure notificações Webhook de {topics} para testes com a URL {callback}. |
notifications_history_diagnostics | Realiza um diagnóstico e obtém relatórios dos eventos disparados sobre uma determinada integração, incluindo métricas de entrega e análise caso ela falhe, para poder implementar melhorias. | N/A | Realize um resumo do meu histórico de notificações para validar o funcionamento do meu sistema de Webhooks. |
create_test_user | Cria usuários de teste com credenciais atribuídas e dinheiro disponível para testar fluxos de pagamento. | -site_id (string, obrigatório): ID do site/país para o qual a conta de teste é criada. Pode ser: MLA (Argentina), MLB (Brasil), MLC (Chile), MLM (México), MLU (Uruguai), MPE (Peru), MCO (Colômbia) - description (string, obrigatório): Descrição ou nome do usuário de teste.- profile (string, obrigatório): Tipo de perfil, que pode ser vendedor (seller), comprador (buyer), ou integrador (integrator). - amount (number, opcional): dinheiro inicial atribuído ao usuário, que deve estar de acordo com os limites estabelecidos para o país ao qual pertence. Se não for enviado, será atribuído 1000 por padrão. | Crie um usuário de teste do Mercado Pago para Argentina (MLA) com perfil de vendedor (seller), com a descrição 'Usuário vendedor para testes de checkout' e um saldo inicial de 5000. |
add_money_test_user | Adiciona dinheiro à conta de um usuário de teste no Mercado Pago para testar fluxos de pagamento. O valor será validado e ajustado de acordo com os limites específicos de cada país. | -test_user_id (number, obrigatório): User ID do usuário de teste ao qual será atribuído dinheiro. - amount (number, obrigatório): Valor de dinheiro a adicionar, que deve estar de acordo com os limites estabelecidos para o país de operação atribuído ao usuário: para Argentina, México, Chile, Uruguai, Peru e Colômbia, deve ser entre 1000 e 50000; para Brasil, entre 100 e 50000 BRL. | Adicione 10000 de saldo à conta do usuário de teste com o ID {test_user_id}. |
get_credentials | Disponível somente via OAuth. Retorna as credenciais (Client ID, Client Secret, Access Token e Public Key ) de produção e teste de uma aplicação do Mercado Pago Developers do usuário autenticado. | -application_id (string, opcional): ID da aplicação. Se o ID não for informado e o usuário tiver apenas uma aplicação, está será retornada automaticamente na busca. Caso haja mais de uma, serão listadas todas as aplicações do usuário e uma deverá ser escolhida. | Mostre as credenciais da minha aplicação {application_id}. |
create_application | Disponível somente via OAuth. Cria uma nova aplicação do Mercado Pago Developers para o usuário autenticado. Captura o contexto da conversa e se já tiver todas as informações necessárias, cria a aplicação sem perguntar nada ao usuário. Caso falte algum dado, solicita apenas as informações ausentes. O OAuth detecta automaticamente o país (site_id) para qual a aplicação será criada. | -name (string, obrigatório): Nome da aplicação. Máximo 50 caracteres. - payment_solution (enum, obrigatório): online_payments (pagamentos online) ou in_person_payments (pagamentos presenciais). - product (enum, obrigatório): checkout_pro, checkout_api, checkout_bricks, subscription, point e qr_code. - platform (enum, opcional): Plataforma de e-commerce (ex: woocommerce, shopify, etc). - api_type (enum, opcional apenas para checkout_api): orders ou payments. - description (string, opcional): Descrição da aplicação. Máximo 150 caracteres. - website_url (string, opcional): URL do site de produção. - redirect_url (string, opcional): URL de callback para OAuth. | Crie uma nova aplicação do Mercado Pago para integrar {produto} no meu e-commerce. |
get_application | Disponível somente via OAuth. Obtém informações sobre as aplicações criadas em uma conta do Mercado Pago Developers. O usuário pode buscar uma aplicação sem precisar de outros MCPs. Se tiver apenas uma aplicação, o sistema a detecta automaticamente sem que o application_id precise ser informado. | N/A | Mostre minhas aplicações do Mercado Pago. |