{"_id":"@atehra/mcp","_rev":"4-958efed97930eca176dd55252fc83a0f","name":"@atehra/mcp","dist-tags":{"latest":"0.3.0"},"versions":{"0.1.0":{"name":"@atehra/mcp","version":"0.1.0","keywords":["atehra","mcp","model-context-protocol","fintech","billing","brazil","pix","boleto","claude","cursor"],"license":"MIT","_id":"@atehra/mcp@0.1.0","maintainers":[{"name":"possato","email":"franciscopossatoamaral@gmail.com"}],"homepage":"https://atehra.com/mcp","bugs":{"url":"https://github.com/atehra/atehra/issues"},"bin":{"atehra-mcp":"dist/index.js"},"dist":{"shasum":"9db0835ce1d49f13df422f29712ff89119f1056c","tarball":"https://registry.npmjs.org/@atehra/mcp/-/mcp-0.1.0.tgz","fileCount":24,"integrity":"sha512-kajTpVGbMJTyPQsfE/pQLRoE3qTwpPp35Dugl4QZsijpGJMt4l0pnBzeWzAQbw0FOYlsI7a+LPUW8YV3uub7KA==","signatures":[{"sig":"MEUCIFz1ii2/26ACHKplttqPyXiXx4sPHeDrHobX0/3Kz011AiEA/iopsNyBdFPLNyFOk02o2KMHNxgpH1lrsGUN35JOZTw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":50715},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"c8d3fda99f71847b33a887edd38e8d06c4eb8166","scripts":{"dev":"tsc --watch","build":"tsc","smoke":"node --test dist/tests/smoke.test.js","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"possato","email":"franciscopossatoamaral@gmail.com"},"repository":{"url":"git+https://github.com/atehra/atehra.git","type":"git","directory":"mcp"},"_npmVersion":"10.8.2","description":"Servidor MCP oficial da Atehra — opere a infraestrutura financeira BR via Claude, Cursor, ChatGPT e qualquer cliente MCP","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0_1778708926585_0.66068949068789","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@atehra/mcp","version":"0.2.0","keywords":["atehra","mcp","model-context-protocol","fintech","billing","brazil","pix","boleto","claude","cursor"],"license":"MIT","_id":"@atehra/mcp@0.2.0","maintainers":[{"name":"possato","email":"franciscopossatoamaral@gmail.com"}],"homepage":"https://atehra.com/mcp","bugs":{"url":"https://github.com/atehra/atehra/issues"},"bin":{"atehra-mcp":"dist/index.js","atehra-mcp-http":"dist/index-http.js"},"dist":{"shasum":"12b9dcbc713a1faf1fcff21d516008cc073cb6d8","tarball":"https://registry.npmjs.org/@atehra/mcp/-/mcp-0.2.0.tgz","fileCount":30,"integrity":"sha512-iup+1FLziaWYMJqlhjFdroOUcU6ibHuEpJBiMKglTdKvIkAVzUQkZJVGYDVbvUDeN9muqyhu4JyD9FpiUKZSQQ==","signatures":[{"sig":"MEUCIQDYQrRbgMWDiZP4YlVbIXK9NMC6U96/gp8xjmvQ/hc3rgIgM0oMGdUUm+7RSLtPMKtw8GH9kf0huCvrXAZFjBo3/H4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":60244},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"c8d3fda99f71847b33a887edd38e8d06c4eb8166","scripts":{"dev":"tsc --watch","build":"tsc && chmod +x dist/index.js dist/index-http.js","smoke":"node --test dist/tests/smoke.test.js","start":"node dist/index-http.js","start:stdio":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"possato","email":"franciscopossatoamaral@gmail.com"},"repository":{"url":"git+https://github.com/atehra/atehra.git","type":"git","directory":"mcp"},"_npmVersion":"10.8.2","description":"Servidor MCP oficial da Atehra — opere a infraestrutura financeira BR via Claude, Cursor, ChatGPT e qualquer cliente MCP. Suporta stdio (local) e HTTP/SSE (remoto, via Connectors UI do Claude).","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.0_1778710047929_0.7713281729794077","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@atehra/mcp","version":"0.2.1","keywords":["atehra","mcp","model-context-protocol","fintech","billing","brazil","pix","boleto","claude","cursor"],"license":"MIT","_id":"@atehra/mcp@0.2.1","maintainers":[{"name":"possato","email":"franciscopossatoamaral@gmail.com"}],"homepage":"https://atehra.com/mcp","bugs":{"url":"https://github.com/atehra/atehra/issues"},"bin":{"atehra-mcp":"dist/index.js","atehra-mcp-http":"dist/index-http.js"},"dist":{"shasum":"ef73f1a7a02bb32d55f960b503a0add86cac90d6","tarball":"https://registry.npmjs.org/@atehra/mcp/-/mcp-0.2.1.tgz","fileCount":30,"integrity":"sha512-1o7o7DOVGmWuXRqQydPVJmiZ1mYZeZfRq+nXfX5mK/fniZekofziWlvPDbETpukFoSjBbyLQpkD+FH098FxQ9Q==","signatures":[{"sig":"MEQCIHO11lZaoglRMtmyaaDG9LUMGJoYNG2ChAcCwKdP44P4AiAucj//9jgTBa2wPfJLf0bTYhtpzZ5gsDCURm8O/MfPsg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":60222},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"c8d3fda99f71847b33a887edd38e8d06c4eb8166","scripts":{"dev":"tsc --watch","build":"tsc && chmod +x dist/index.js dist/index-http.js","smoke":"node --test dist/tests/smoke.test.js","start":"node dist/index-http.js","start:stdio":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"possato","email":"franciscopossatoamaral@gmail.com"},"repository":{"url":"git+https://github.com/atehra/atehra.git","type":"git","directory":"mcp"},"_npmVersion":"10.8.2","description":"Servidor MCP oficial da Atehra — opere a infraestrutura financeira BR via Claude, Cursor, ChatGPT e qualquer cliente MCP. Suporta stdio (local) e HTTP/SSE (remoto, via Connectors UI do Claude).","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.1_1778710921772_0.9142533760317311","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@atehra/mcp","version":"0.3.0","description":"Servidor MCP oficial da Atehra — opere a infraestrutura financeira BR via Claude, Cursor, ChatGPT e qualquer cliente MCP. Suporta stdio (local) e HTTP/SSE (remoto, via Connectors UI do Claude).","type":"module","main":"dist/index.js","bin":{"atehra-mcp":"dist/index.js","atehra-mcp-http":"dist/index-http.js"},"scripts":{"build":"tsc && chmod +x dist/index.js dist/index-http.js","dev":"tsc --watch","start":"node dist/index-http.js","start:stdio":"node dist/index.js","smoke":"node --test dist/tests/smoke.test.js","prepublishOnly":"npm run build"},"keywords":["atehra","mcp","model-context-protocol","fintech","billing","brazil","pix","boleto","claude","cursor"],"license":"MIT","homepage":"https://atehra.com/mcp","repository":{"type":"git","url":"git+https://github.com/atehra/atehra.git","directory":"mcp"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.4","jose":"^6.2.3","zod":"^3.23.8"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.5.0"},"engines":{"node":">=18"},"_id":"@atehra/mcp@0.3.0","gitHead":"c8d3fda99f71847b33a887edd38e8d06c4eb8166","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/atehra/atehra/issues"},"_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-yzG+GAd5q4+XksY3COWBCZf/fO9e61VvOJUFDLq5LaxeaQeDzrgTTcOegnidT/z9hunLa8lGhEXcfvIJVBbB5w==","shasum":"d3f4d63140deab269e205feb31dff9d70fe83945","tarball":"https://registry.npmjs.org/@atehra/mcp/-/mcp-0.3.0.tgz","fileCount":32,"unpackedSize":66639,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHX4R/bbOhmN3D3GaZ9ADF1OTqNOEdyh1SH7hgl7ekyGAiEA8W01qe/Upan6nx39TIOPrtiSTS6ceyqJtcTjCNy3mGE="}]},"_npmUser":{"name":"possato","email":"franciscopossatoamaral@gmail.com"},"directories":{},"maintainers":[{"name":"possato","email":"franciscopossatoamaral@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.3.0_1778732761618_0.7086666603112983"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-13T21:48:46.495Z","modified":"2026-05-14T04:26:01.935Z","0.1.0":"2026-05-13T21:48:46.724Z","0.2.0":"2026-05-13T22:07:28.099Z","0.2.1":"2026-05-13T22:22:01.930Z","0.3.0":"2026-05-14T04:26:01.780Z"},"bugs":{"url":"https://github.com/atehra/atehra/issues"},"license":"MIT","homepage":"https://atehra.com/mcp","keywords":["atehra","mcp","model-context-protocol","fintech","billing","brazil","pix","boleto","claude","cursor"],"repository":{"type":"git","url":"git+https://github.com/atehra/atehra.git","directory":"mcp"},"description":"Servidor MCP oficial da Atehra — opere a infraestrutura financeira BR via Claude, Cursor, ChatGPT e qualquer cliente MCP. Suporta stdio (local) e HTTP/SSE (remoto, via Connectors UI do Claude).","maintainers":[{"name":"possato","email":"franciscopossatoamaral@gmail.com"}],"readme":"# @atehra/mcp\n\nServidor MCP (Model Context Protocol) oficial da Atehra. Permite que Claude, Cursor, ChatGPT e qualquer cliente MCP operem a infraestrutura financeira BR da Atehra em linguagem natural.\n\n> **A primeira fintech brasileira projetada pra rodar via agente de IA.**\n\n## Dois jeitos de usar\n\n| Jeito | Quando usar | Como |\n|---|---|---|\n| **Remoto (HTTP/SSE)** | Maioria dos casos. Sem instalar nada. | Cola URL na UI dos Connectors do Claude |\n| **Local (stdio)** | Self-hosting ou ambientes sem internet | `npx -y @atehra/mcp` via config JSON |\n\n## Uso remoto (recomendado) — UI dos Connectors\n\nNo Claude Desktop, vai em **Settings → Connectors → Adicionar conector personalizado** e cola:\n\n```\nURL: https://mcp.atehra.com/mcp\n```\n\nEm **Configurações avançadas**, adiciona header:\n\n```\nx-api-key: atk_test_SUA_CHAVE_AQUI\n```\n\nSalva. Pronto — 16 ferramentas Atehra disponíveis no Claude.\n\n## O que dá pra fazer\n\nCom este servidor ligado, seu agente de IA pode:\n\n- **Consultar saldo, A receber, antecipações disponíveis** em tempo real\n- **Criar cobranças** em PIX ou boleto pra qualquer cliente\n- **Gerar links de pagamento** reutilizáveis\n- **Antecipar vendas no cartão** com cotação prévia\n- **Sacar saldo** pra conta externa via PIX ou TED\n- **Configurar a régua de cobrança** em linguagem natural\n- **Ver métricas do negócio** (receita recorrente mensal, taxa de cancelamento, valor por cliente)\n- **Listar clientes, assinaturas e faturas** com filtros\n\n## Uso local (stdio)\n\n### Pré-requisitos\n\n1. Conta na Atehra (`atehra.com`)\n2. API key (`atk_test_...` pra sandbox, `atk_live_...` pra produção)\n3. Node.js 18+\n\n### No Claude Desktop\n\nAdicione ao arquivo de configuração (`~/Library/Application Support/Claude/claude_desktop_config.json` no macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"atehra\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@atehra/mcp\"],\n      \"env\": {\n        \"ATEHRA_API_KEY\": \"atk_test_sua_chave_aqui\"\n      }\n    }\n  }\n}\n```\n\nReinicie o Claude Desktop. Pronto.\n\n### No Cursor\n\nAdicione ao `.cursor/mcp.json` no seu projeto:\n\n```json\n{\n  \"mcpServers\": {\n    \"atehra\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@atehra/mcp\"],\n      \"env\": {\n        \"ATEHRA_API_KEY\": \"atk_test_sua_chave_aqui\"\n      }\n    }\n  }\n}\n```\n\n## Modo sandbox vs produção\n\nO servidor detecta o modo pelo prefixo da chave:\n\n- `atk_test_...` → sandbox (dados de teste, dinheiro não é real)\n- `atk_live_...` → produção (dinheiro é real)\n\n**Recomendação forte:** comece sempre em sandbox.\n\n## Segurança em produção\n\nEm produção (`atk_live_`), ações que movem dinheiro real exigem **confirmação dupla**:\n\n1. Você pede pro Claude executar (ex.: \"saca tudo pra minha conta principal\")\n2. O servidor retorna: \"Vou sacar R$ X pra conta Y. Confirme chamando de novo com `confirm: true`\"\n3. Claude repassa pra você pedir confirmação humana\n4. Você confirma\n5. Claude chama de novo com `confirm: true` e a ação executa\n\nEm sandbox a confirmação é pulada (tudo é teste).\n\n## As 16 ferramentas\n\n### Saldo e dinheiro\n- `get_balance` — saldo disponível e a receber\n- `list_anticipatable_payments` — vendas no cartão que dão pra antecipar\n- `quote_anticipation` — calcular taxa e valor líquido\n- `request_anticipation` — antecipar pagamento (confirmação dupla em produção)\n- `request_withdrawal` — sacar saldo (confirmação dupla em produção)\n\n### Cobrar e clientes\n- `create_customer` — criar cliente\n- `list_customers` — listar clientes\n- `create_plan` — criar plano de produto (assinatura ou avulso)\n- `create_checkout_session` — gerar cobrança PIX ou boleto pra um cliente\n- `create_checkout_link` — gerar link de pagamento reutilizável\n- `list_recent_orders` — listar últimas vendas\n\n### Números do negócio\n- `get_metrics_overview` — receita, MRR, churn, ARPU, LTV\n- `list_subscriptions` — assinaturas ativas\n- `list_invoices` — faturas (pagas, pendentes, vencidas)\n\n### Régua de cobrança\n- `get_dunning_config` — ver régua atual\n- `update_dunning_config` — atualizar régua de cobrança\n\n## Exemplos de uso\n\nCom o servidor ligado, peça ao Claude:\n\n> \"Quanto eu tenho de saldo e quanto posso antecipar agora?\"\n\n> \"Cria cliente Maria Silva com email maria@exemplo.com.br e CPF 12345678900, depois cria uma cobrança PIX de R$ 1.500 com vencimento sexta.\"\n\n> \"Configura a régua: tenta cobrar de novo no dia 1, manda email no dia 3, suspende no dia 7.\"\n\n> \"Quais clientes têm fatura vencida há mais de 5 dias?\"\n\n> \"Como tá o MRR esse mês comparado ao anterior?\"\n\n## Variáveis de ambiente\n\n| Variável | Obrigatório | Descrição |\n|---|---|---|\n| `ATEHRA_API_KEY` | Sim | Chave da API (`atk_test_...` ou `atk_live_...`) |\n| `ATEHRA_BASE_URL` | Não | URL base da API. Padrão: `https://api.atehra.com` |\n\n## Desenvolvimento\n\n```bash\nnpm install\nnpm run build\nnpm start\n```\n\nPra testar localmente com o Claude Desktop, aponte o `command` pro `node` e o `args` pro caminho do `dist/index.js`:\n\n```json\n{\n  \"command\": \"node\",\n  \"args\": [\"/caminho/absoluto/para/atehra/mcp/dist/index.js\"],\n  \"env\": { \"ATEHRA_API_KEY\": \"atk_test_...\" }\n}\n```\n\n## Licença\n\nMIT\n","readmeFilename":"README.md"}