io.github.CssEoCAO/notamcp · v1.0.0 · finance-and-payments
NotaMCP is healthy: it completed an MCP handshake in 837 ms and exposes 10 tools.
Issue Brazilian service invoices (NFS-e Nacional) from your AI, with preview and confirmation.
Endpoint: https://notamcp.com.br/mcp (streamable-http)
No repository listed · Website · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 10 |
| Latency | 837 ms |
| Last checked (UTC) | 2026-10-28T18:45:07.718Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-10-28T18:45:07.718Z | Healthy | 837 |
emitir_nota | Prepara uma NFS-e e devolve a PRÉVIA + confirmacao_token. NÃO emite nada. Mostre a prévia ao usuário e chame confirmar_emissao só depois do OK explícito dele. Tomador: informe tomador_id (salvo) OU tomador_doc + tomador_razao. |
listar_configuracoes | Últimas combinações realmente usadas de serviço, CNAE, NBS e tributação. Use configuracao_id em emitir_nota. Se houver ambiguidade, pergunte ao usuário — não escolha nem invente código fiscal. |
confirmar_emissao | Emite DE VERDADE a nota da prévia. Chame apenas depois que o usuário aprovou a prévia nesta conversa. Idempotente: o mesmo token nunca emite duas vezes. Autorizada, devolve danfse_url (PDF) e xml_url — links para o usuário abrir, que você não consegue baixar. |
consultar_nota | Situação de uma nota desta conta (status, número, chave de acesso, erro). |
listar_notas | Histórico de notas da conta, com filtros opcionais. |
cancelar_nota | Cancela uma NFS-e autorizada na SEFIN. Exige confirmar=true — peça confirmação explícita ao usuário antes. O crédito da emissão NÃO volta (a nota existiu); o cancelamento é grátis. |
listar_tomadores | Tomadores salvos desta conta (use o id em emitir_nota). Passe `busca` com o NOME que o usuário falou para achar o tomador sem precisar do CNPJ — ignora acento, caixa e pontuação. Se voltar mais de um, pergunte qual antes de emitir. |
salvar_tomador | Salva/atualiza um tomador frequente (ex.: "salva a Shopee como tomador"). |
saldo | Quantidade de notas disponíveis, preço por nota, ambiente e teto diário. O nome técnico saldo é mantido por compatibilidade. |
comprar_creditos | Gera um link de pagamento (Pix/cartão) para adicionar créditos de notas. Entregue o link ao usuário — o pagamento acontece no navegador dele e as notas entram após a confirmação. |