O MP CLI (mpcli) 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.

Nesta versão, os comandos passam a usar o prefixo mpcli, a instalação chega a uma nova plataforma e a cobertura de comandos cresce com pagamentos avançados e envios.

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

bash
Copiar
mpcli payments search --status rejected --external-reference "ORDER-123"
mpcli preferences create --title "Produto 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 impacto mais visível é a renomeação dos comandos: todos passaram do prefixo mp para mpcli. Por exemplo, mp payments list agora é mpcli payments list. Se você já usava o CLI, basta atualizar o prefixo nos seus scripts.

Além do script original, a instalação agora conta com o Scoop no Windows. Para esta instalação, alguns antivírus podem sinalizar o binário por engano e, se isso acontecer, a documentação oficial explica como proceder com segurança. Em dispositivos macOS corporativos com restrições, o diretório ~/.config/mp pode exigir ajuste de permissões.

A cobertura da API cresceu com novos comandos:

• mpcli advanced-payments: pagamentos divididos e desembolsos.
• mpcli shipping: gestão de envios.
• mpcli config: configuração do CLI.

Comandos existentes também evoluíram: mpcli refunds agora cria reembolsos totais e parciais, mpcli merchant-orders cria e atualiza ordens, mpcli chargebacks lista contestações e mpcli oauth gera a URL de autorização.

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

• Perfis nomeados para alternar entre contas e ambientes sem reautenticar;
• 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 MP 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. Esses comandos usam o Access Token do usuário de teste, não o da sua aplicação, então autentique o perfil de teste antes de operar:

bash
Copiar
mpcli login --token <test-user-token> --profile test
mpcli tester create --site-id MLB --type buyer --profile test
mpcli tester balance set 123456 --amount 10000 --profile test
mpcli tester card add --user-id 123456 --scenario insufficient_funds --profile test

Vale lembrar que o prefixo APP_USR- no Access Token não indica o tipo de conta: ele aparece tanto em produção quanto em teste. Para confirmar a aplicação e o ambiente ativos, use mpcli whoami antes de operar.

Nos próximos lançamentos, o MP CLI continua evoluindo para ampliar a cobertura de comandos e adquirir novas funcionalidades. Entre os recursos a caminho, estão o Webhook Listener (mpcli listen, mpcli events e mpcli trigger) para receber e simular notificações, o histórico de logs (mpcli logs) e a instalação via npm em qualquer plataforma. Consulte a documentação completa do Mercado Pago CLI.