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 wWbhook 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}. |
simulate_webhook | Simula o envio das notificações Webhooks previamente configuradas para sua integração e testa o funcionamento da sua implementação antes de receber notificações reais. | -topic (string, optional): Tópico de notificações Webhook a simular. - url_callback (string, optional): URL para a qual a simulação de notificação será enviada. Se não for fornecida, a simulação é enviada para a URL configurada previamente. - resource_id (string, required): ID do recurso que será simulado. Por exemplo, um payment_id. - callback_env_production (boolean, optional): Permite selecionar se o ambiente a utilizar para a simulação é de produção (true) ou sandbox (false). Se não for enviado, o ambiente padrão é o sandbox. | Simule uma notificação de {topic} em {callback_env_production} com o ID {resource_id}. |
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_application | Obtém informações sobre as aplicações criadas em uma conta do Mercado Pago Developers. Funciona como apoio para as tools que requerem essas informações para serem executadas corretamente. | N/A | N/A (será invocada apenas por outras tools caso precisem confirmar informações sobre aplicações para serem executadas). |