{"_id":"@pushinpaybr/mcp-server","_rev":"3-ca6b00757e39255fef66f67a17c16e13","name":"@pushinpaybr/mcp-server","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@pushinpaybr/mcp-server","version":"0.1.0","keywords":["pushinpay","mcp","model-context-protocol","pix","pagamentos"],"license":"MIT","_id":"@pushinpaybr/mcp-server@0.1.0","maintainers":[{"name":"felipe_pietro","email":"felipe.pietro@pushinpay.com.br"}],"homepage":"https://pushinpay.com.br","bugs":{"url":"https://github.com/Pushin-Pay/pushinpay-mcp-server/issues"},"bin":{"pushinpay-mcp-server":"dist/index.js"},"dist":{"shasum":"c0458edf7f804830dc9fb8250074ed8af7c11ec1","tarball":"https://registry.npmjs.org/@pushinpaybr/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":18,"integrity":"sha512-5qPzU/GAE5dlfVEM3J6So4JjTRz+m64ioDvtCYalGbUZ3+RQQKXHkQLPL5BY/JDfTyKld1JUK+BMP+MpU1Vz0w==","signatures":[{"sig":"MEYCIQDdXh8sFzrj5R9lNQsnuPjrg3h+sE4pb7fd1PW+p5qmLQIhAMZZ2HI7H0drd1bX5BJP47kBdEzKjSWCvWW2YrgzIxll","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":60663},"type":"module","engines":{"node":">=18"},"gitHead":"2070a2d115f37bcc4c125ea44c9f0370f4efaf8e","scripts":{"dev":"tsx watch --env-file=.env src/index.ts","build":"tsc","smoke":"tsx --env-file=.env scripts/smoke.ts","start":"node --env-file-if-exists=.env dist/index.js","inspect":"npm run build && npx @modelcontextprotocol/inspector node --env-file-if-exists=.env dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"felipe_pietro","email":"felipe.pietro@pushinpay.com.br"},"repository":{"url":"git+https://github.com/Pushin-Pay/pushinpay-mcp-server.git","type":"git"},"_npmVersion":"11.17.0","description":"Servidor MCP oficial da PushinPay — permite que agentes de IA (Claude, Cursor) consultem saldo e criem cobranças PIX.","directories":{},"_nodeVersion":"24.19.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"^5.5.4","@types/node":"^22.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.0_1785860037402_0.14277816358966455","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@pushinpaybr/mcp-server","version":"0.1.1","keywords":["pushinpay","mcp","model-context-protocol","pix","pagamentos"],"license":"MIT","_id":"@pushinpaybr/mcp-server@0.1.1","maintainers":[{"name":"felipe_pietro","email":"felipe.pietro@pushinpay.com.br"}],"homepage":"https://pushinpay.com.br","bugs":{"url":"https://github.com/Pushin-Pay/pushinpay-mcp-server/issues"},"bin":{"pushinpay-mcp-server":"dist/index.js"},"dist":{"shasum":"6d8e1a8c560bb591efc57bbc3326ce79e24c156e","tarball":"https://registry.npmjs.org/@pushinpaybr/mcp-server/-/mcp-server-0.1.1.tgz","fileCount":18,"integrity":"sha512-VHzcHb2Hz24EkX41Tlg9UC0U2/w7Fn66hVbCBPIjgmU4QU7FAnZ/IF9d33A259TLySjlwVtG/hvcyUJBKa/dFQ==","signatures":[{"sig":"MEUCIQCbuDEuHBsvbxVZtjzfBuYvPmTo0f8JEP+/rt3XiWvBUQIgU1VIcHop4HkZ4+fp/P0v+zfTqqutp/G+oSB2bNyIdAw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":60700},"type":"module","engines":{"node":">=18"},"gitHead":"dc4066f8f20832b74ee454807e9401762be73ffa","mcpName":"br.com.pushinpay/mcp","scripts":{"dev":"tsx watch --env-file=.env src/index.ts","build":"tsc","smoke":"tsx --env-file=.env scripts/smoke.ts","start":"node --env-file-if-exists=.env dist/index.js","inspect":"npm run build && npx @modelcontextprotocol/inspector node --env-file-if-exists=.env dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"felipe_pietro","email":"felipe.pietro@pushinpay.com.br"},"repository":{"url":"git+https://github.com/Pushin-Pay/pushinpay-mcp-server.git","type":"git"},"_npmVersion":"11.17.0","description":"Servidor MCP oficial da PushinPay — permite que agentes de IA (Claude, Cursor) consultem saldo e criem cobranças PIX.","directories":{},"_nodeVersion":"24.19.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"^5.5.4","@types/node":"^22.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.1_1785866473652_0.10304631441736056","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-08-04T16:13:57.224Z","modified":"2026-08-04T18:54:47.716Z","0.1.0":"2026-08-04T16:13:57.522Z","0.1.1":"2026-08-04T18:01:13.800Z"},"bugs":{"url":"https://github.com/Pushin-Pay/pushinpay-mcp-server/issues"},"license":"MIT","homepage":"https://pushinpay.com.br","keywords":["pushinpay","mcp","model-context-protocol","pix","pagamentos"],"repository":{"url":"git+https://github.com/Pushin-Pay/pushinpay-mcp-server.git","type":"git"},"description":"Servidor MCP oficial da PushinPay — permite que agentes de IA (Claude, Cursor) consultem saldo e criem cobranças PIX.","maintainers":[{"email":"felipe.pietro@pushinpay.com.br","name":"felipe_pietro"},{"email":"murilo.mazzeu@pushinpay.com.br","name":"murilo-pushinpay"}],"readme":"# @pushinpaybr/mcp-server\n\nServidor [MCP](https://modelcontextprotocol.io) oficial da **PushinPay**. Conecta agentes de IA (Claude Desktop, Claude Code, Cursor) à API PushinPay para operações PIX — sem escrever código de integração.\n\n> **Status:** v1 (em construção). Escopo somente-leitura + criação de cobrança. **Não** expõe saque, reembolso ou alteração de conta, por segurança.\n\n## Tools disponíveis\n\n| Tool | Descrição |\n|------|-----------|\n| `consultar_saldo` | Saldo disponível e valor bloqueado da conta |\n| `consultar_transacao` | Status de uma transação PIX pelo ID (trava de 1 consulta/min embutida) |\n| `criar_cobranca_pix` | Cria cobrança PIX (copia-e-cola + QR Code), com split opcional |\n\n> Escopo v1: por segurança, **não** há saque, reembolso nem alteração de conta.\n\n## Uso rápido\n\nNão precisa clonar nada — roda direto via `npx`:\n\n```bash\nnpx -y @pushinpaybr/mcp-server\n```\n\nO servidor lê a configuração de variáveis de ambiente:\n\n| Variável | Obrigatória | Padrão | Descrição |\n|----------|-------------|--------|-----------|\n| `PUSHINPAY_TOKEN` | sim | — | Token da sua conta (gere no painel) |\n| `PUSHINPAY_ENV` | não | `sandbox` | `sandbox` ou `production` |\n\n## Configuração no cliente de IA\n\n### Claude Desktop / Claude Code\n\nAdicione ao seu arquivo de config MCP:\n\n```json\n{\n  \"mcpServers\": {\n    \"pushinpay\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@pushinpaybr/mcp-server\"],\n      \"env\": {\n        \"PUSHINPAY_TOKEN\": \"seu_token_aqui\",\n        \"PUSHINPAY_ENV\": \"sandbox\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\nEm `~/.cursor/mcp.json` (ou nas configurações de MCP do projeto), use o mesmo bloco acima.\n\nDepois de configurar, peça em linguagem natural: _\"Qual meu saldo na PushinPay?\"_\n\n## Desenvolvimento\n\n```bash\nnpm install\nnpm run build      # compila TypeScript -> dist/\nnpm run dev        # roda em watch mode\nnpm run smoke      # teste ponta a ponta: autentica e lê o saldo\nnpm run inspect    # abre o MCP Inspector (UI para testar as tools)\n```\n\nCopie `.env.example` para `.env` e preencha `PUSHINPAY_TOKEN` para os testes locais.\n\n## Especificação e Skill (download público)\n\n- [`openapi.yaml`](openapi.yaml) — especificação OpenAPI 3.0 do núcleo PIX da API (cobrança, transação, reembolso, saque, saldo, assinaturas). Importe no Postman/Insomnia ou gere clientes automaticamente.\n- [`skill/SKILL.md`](skill/SKILL.md) — Skill para Claude com as regras de uso da PushinPay. O arquivo `.skill` distribuível é essa pasta compactada.\n\n## Segurança\n\n- O token é lido do ambiente e **nunca** é logado.\n- Tokens da PushinPay podem ser **atrelados a IP**. Para uso via MCP (máquina do dev, IP dinâmico), gere um token com IP liberado ou use o ambiente sandbox.\n- Reporte vulnerabilidades conforme `SECURITY.md`.\n\n## Licença\n\nMIT\n","readmeFilename":"README.md"}