MCP Server
Pagamentos por prompt.
Conecte seu agente de IA à Garu com um comando. Cobranças PIX, cartão e boleto, clientes e transações — tudo via linguagem natural, sem sair do editor.
$ claude mcp add garu -e GARU_API_KEY=sk_test_xxx -- npx -y @garuhq/mcp
Por que MCP
Automatize pagamentos com MCP.
Agilidade
Crie cobranças sem alternar de janela.
Parceria
Funciona com Claude Code, Cursor, Codex, Windsurf e qualquer cliente MCP.
Autonomia
Sua chave, seus dados, seu agente — sem intermediários.
~/.config/garu/mcp.json
{
"mcpServers": {
"garu": {
"command": "npx",
"args": ["-y", "@garuhq/mcp"],
"env": {
"GARU_API_KEY": "sk_test_xxx"
}
}
}
}Na prática
Peça ao seu agente.
Catálogo
Tudo que seu agente precisa.
Onze ferramentas para gerenciar cobranças e clientes na Garu.
Cobranças
create_charge
Cria uma nova cobrança (PIX, Cartão ou Boleto).
list_charges
Lista cobranças com filtros por status, data ou cliente.
get_charge
Consulta os detalhes de uma cobrança pelo ID.
refund_charge
Reembolsa total ou parcialmente uma cobrança paga.
cancel_charge
Cancela uma cobrança pendente antes do pagamento.
get_charge_status
Consulta o status atual de uma cobrança.
Clientes
create_customer
Cadastra um novo cliente com nome, email e CPF/CNPJ.
list_customers
Lista clientes com filtros por nome, email ou data.
get_customer
Consulta os detalhes de um cliente pelo ID.
update_customer
Atualiza dados de contato ou documento de um cliente.
delete_customer
Remove um cliente do cadastro.
Para começar
Onde você já trabalha
Em 5 minutos
Você está integrado.
1. INSTALE
Um comando no terminal ou um arquivo de config no projeto.
2. AUTENTIQUE
Sua chave sk_test_ ou sk_live_ do dashboard.
3. USE
Peça em linguagem natural — o agente cuida do resto.
Pronto para integrar?
Dúvidas
Perguntas frequentes.
O Model Context Protocol (MCP) é um padrão aberto que conecta agentes de IA a ferramentas externas. Com o MCP da Garu, seu agente cria cobranças, gerencia clientes e consulta transações em linguagem natural.
Sim. O servidor MCP é open source no GitHub e o pacote @garuhq/mcp é gratuito no npm. Você paga apenas as taxas de processamento das cobranças que efetivamente forem pagas, como em qualquer integração com a Garu.
Sim — esses são os clientes oficialmente suportados via stdio. Qualquer outro cliente compatível com o protocolo MCP também consegue conectar. Para integrações remotas, o servidor também roda em modo HTTP.
No dashboard da Garu, vá em Configurações → Desenvolvedores → Criar chave de API. Use uma chave de teste (sk_test_) durante o desenvolvimento e troque para a chave de produção (sk_live_) ao publicar.
Sim. O MCP usa exatamente a mesma API que o resto da Garu, com as mesmas garantias de SLA e segurança. Para produção, use uma chave sk_live_ e mantenha-a fora do controle de versão (variável de ambiente ou segredo do CI).
Cobranças pendentes podem ser canceladas com a ferramenta cancel_charge ou pelo dashboard. Cobranças pagas podem ser reembolsadas (refund_charge), total ou parcialmente. O agente também pode revisar a operação antes de chamar a ferramenta — boa prática é pedir confirmação para valores acima de um limiar.