O MP CLI (mp) coloca os recursos da API do Mercado Pago no terminal com um único Access TokenAccess TokenChave privada da aplicação criada no Mercado Pago e que é utilizada no backend. Você pode acessá-la através de Suas integrações > Detalhes da aplicação > Testes > Credenciais de teste ou Produção > Credenciais de produção. da sua aplicação, permitindo que você opere pagamentos, assinaturas, lojas e relatórios sem precisar de browser, GUI, ou trocar de contexto no seu agente de IA.

Imagine que um cliente reportou uma falha no pagamento. Com o MP CLI, você identifica e age sem sair do terminal:

plain
Copiar
mp payments search --status rejected --external-reference "ORDER-123"
mp preferences create --title "Producto X" --unit-price 299.90 --quantity 1 --payer-email cliente@email.com

Em dois comandos, você encontrou o problema e criou uma nova preferência de pagamento com parcelamento. Sem abrir o painel, sem montar cURLs, sem perder o contexto.

Pensando em segurança, as credenciais ficam no keychain nativo do sistema operacional, não em arquivos de configuração ou no histórico do shell. Isso resolve o problema de expor tokens acidentalmente em repositórios ou logs. Todos os comandos retornam JSON por padrão, então você conecta o CLI a qualquer script existente sem camada adicional de parsing.

O Mercado Pago CLI conta com recursos para todos os cenários:

Para times de desenvolvimento, recursos que eliminam a configuração repetitiva:

1. Perfis nomeados para alternar entre contas e ambientes sem reautenticar;
2. Arquivo .mp.toml na raiz do repositório com os defaults compartilhados. Qualquer pessoa que clonar o projeto já herda o perfil e o país de operação configurados.

Para pipelines de CI/CD, basta exportar o Access Token como variável de ambiente e usar a flag --no-interactive para garantir que nenhum prompt bloqueie a execução.

Para agentes de IA, nosso CLI foi pensado desde o início para funcionar com agentes. Formato JSON por padrão, --silent, --no-interactive e exit codes categorizados por tipo de erro permitem que um agente de IA opere sua integração com Mercado Pago de forma segura e estruturada, sem precisar interpretar respostas brutas da API ou gerenciar credenciais no contexto da conversa.

Por fim, a possibilidade de testes em sandbox pelo terminal: em vez de configurar usuários de teste pelo dashboard, você cria compradores, define saldo virtual e provisiona cartões com comportamentos específicos diretamente pelo terminal:

plain
Copiar
mp tester create --site-id MLB --type buyer
mp tester balance set 123456 --amount 10000
mp tester card add --user-id 123456 --scenario insufficient_funds

Nos próximos lançamentos, o CLI ganha novas opções de instalação além do Homebrew e expande a cobertura de comandos até chegar a 100% da API do Mercado Pago.

Consulte a documentação completa do novo recurso.