PushinPay MCP Server
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PUSHINPAY_ENV | No | Ambiente de execução: `sandbox` ou `production`. | sandbox |
| PUSHINPAY_TOKEN | Yes | Token da sua conta PushinPay (gere no painel). Obrigatória. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| consultar_saldoA | Retorna o saldo disponível e o valor bloqueado da conta PushinPay. Todos os valores são em centavos (ex.: 1000 = R$ 10,00). |
| consultar_transacaoA | Consulta o status de uma transação PIX pelo ID. Status possíveis: created, paid, canceled (não existe 'failed'). IMPORTANTE: a API permite no máximo 1 consulta por minuto por transação — consultas mais frequentes podem BLOQUEAR a conta. Esta tool aplica essa trava automaticamente e orienta o uso de webhooks para confirmação de pagamento. |
| criar_cobranca_pixA | Cria uma cobrança PIX (cash-in) e retorna o código copia-e-cola (EMV) e o QR Code. Valores SEMPRE em centavos (ex.: 1000 = R$ 10,00; nunca decimais). Opcionalmente aceita split entre contas PushinPay e uma webhook_url para notificação. Após criar, prefira aguardar o pagamento via webhook em vez de ficar consultando o status. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 3 tools
Each tool targets a clearly distinct resource and action: balance lookup, single-transaction status lookup by ID, and PIX charge creation. There is no plausible overlap that would cause misselection, and descriptions reinforce the boundaries (e.g. criar_cobranca_pix explicitly tells the agent to prefer webhooks over polling consultar_transacao).
All three names follow a consistent Portuguese verb_noun pattern (consultar_saldo, consultar_transacao, criar_cobranca_pix) in snake_case with no mixed conventions. The vocabulary (consultar for reads, criar for writes) is predictable and readable.
Three tools is lean but each earns its place for a narrow PIX cash-in integration, covering the core read-balance, read-status, and create-charge flows. It sits at the thin end of the acceptable range, since a payments API surface would typically warrant a few more operations.
Core cash-in lifecycle is covered (create charge, check status, check balance), but there are notable gaps: no transaction listing/history, no cancel or refund operation, and no webhook registration or management tool despite webhooks being the recommended confirmation path. Agents hitting those needs would have no tool to call.