NotaMCP
Server Details
Issue Brazilian service invoices (NFS-e Nacional) from your AI, with preview and confirmation.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- NotaMCP
TDQS
Scored across 15 tools
The set is cleanly partitioned into NFS-e (service) and NF-e/NFC-e (product) families via the `_produto` suffix, and the preview/confirm split (`emitir_nota` vs `confirmar_emissao`) is explicit and reinforced by strong descriptions. The main risk is that paired names like `cancelar_nota`/`cancelar_nota_produto` and `consultar_nota`/`consultar_nota_produto` differ only by a suffix, so an agent must read the description to avoid picking the wrong document type. `consultar_nota` (single status) vs `listar_notas` (history) is a smaller but real overlap.
Nearly all tools follow a Portuguese verb_noun snake_case pattern (emitir_nota, cancelar_nota, listar_tomadores, salvar_tomador, consultar_nota_produto), applied consistently across both document families. The outliers are `saldo` (bare noun, no verb) and `emitente_fiscal` (noun+adjective, and it secretly does both read and write depending on arguments). These deviations are minor and readable but break the otherwise predictable scheme.
15 tools sits at the top of the well-scoped band and each one maps to a distinct step in the fiscal-note lifecycle (configure, preview, confirm, query, list, cancel, plus credits and tomador management). Nothing looks redundant or padded, and the dual NFS-e/NF-e surface justifies the near-doubling of verbs.
Core lifecycle is fully covered for both document types: configuration read/write, preview, idempotent confirmation with PDF/XML links, status query, history listing, cancellation, credits, and tomador save/list. Gaps remain that an agent could hit: no way to delete or update a saved tomador, no NF-e correction letter (carta de correção) or number inutilization, no SEFAZ service-status check, and no tool to set the NFC-e CSC (explicitly pushed to the panel/API).
Available Tools
15 toolscancelar_notaCancelar uma notaADestructiveInspect
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.
Inputs: motivo (required), nota_id (required), confirmar (required), codigo_motivo.
cancelar_nota_produtoCancelar nota de produtoADestructiveInspect
Cancela uma NF-e ou NFC-e autorizada. Efeito fiscal que não se desfaz: chame só com pedido explícito do usuário, com a justificativa dele (15 a 255 caracteres) e confirmar=true. O prazo é o da legislação; fora dele a SEFAZ recusa. O crédito da emissão não volta.
Inputs: id (required), tipo (required), confirmar (required), justificativa (required).
comprar_creditosAdicionar créditos de notasAInspect
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.
Inputs: valor_centavos (required).
confirmar_emissaoConfirmar e emitir a NFS-eADestructiveInspect
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.
Inputs: confirmacao_token (required).
consultar_notaConsultar uma notaARead-onlyIdempotentInspect
Situação de uma nota desta conta (status, número, chave de acesso, erro).
Inputs: nota_id (required).
consultar_nota_produtoConsultar nota de produtoBRead-onlyIdempotentInspect
Situação de uma NF-e ou NFC-e desta conta: status, número, chave de acesso e, se rejeitada, o motivo que a SEFAZ deu. Traz xml_url e pdf_url, que exigem a chave de API: entregue os links, não diga que leu os arquivos.
Inputs: id (required), tipo (required).
emitente_fiscalVer ou ajustar os dados fiscais do emitenteAInspect
Sem argumentos, mostra o que falta para emitir nota de produto (inscrição estadual, regime tributário, séries). Com argumentos, grava: ie (inscrição estadual), crt (1 Simples Nacional, 2 Simples com excesso de sublimite, 3 regime normal, 4 MEI), fantasia, telefone e o próximo número de cada série. O CSC da NFC-e é segredo e se cadastra pela API ou pelo painel, não por aqui.
Inputs: ie, crt, csc_id, series, +3 more.
emitir_notaPreparar emissão de NFS-e (prévia)AInspect
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.
Inputs: valor (required), discriminacao (required), tomador_id, competencia, +6 more.
emitir_nota_produtoPreparar nota de produto (NF-e ou NFC-e)AInspect
Prepara uma NF-e (tipo "nfe", venda para empresa ou pessoa com entrega) ou NFC-e (tipo "nfce", venda no balcão ao consumidor). NÃO emite: valida o documento de verdade (monta, assina e confere no leiaute) e devolve uma prévia com confirmacao_token. Mostre a prévia e chame confirmar_emissao só depois do OK explícito do usuário. Não há cálculo de imposto: emitente do Simples Nacional ou MEI pode omitir icms, pis e cofins nos itens; no regime normal o usuário (ou o contador) precisa informar cada grupo. Nunca invente NCM, CFOP ou CST: pergunte. Para testar sem valor fiscal e sem custo, use "ambiente": "homologacao".
Inputs: itens (required), tipo, extra, serie, +16 more.
listar_configuracoesListar configurações fiscais recentesARead-onlyIdempotentInspect
Ú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.
Inputs: limite.
listar_notasListar notasCRead-onlyIdempotentInspect
Histórico de notas da conta, com filtros opcionais.
Inputs: limite, status, competencia.
listar_notas_produtoListar notas de produtoCRead-onlyIdempotentInspect
Últimas NF-e ou NFC-e da conta, da mais nova para a mais antiga.
Inputs: tipo (required), limite, status, ambiente.
listar_tomadoresListar tomadores salvosARead-onlyIdempotentInspect
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.
Inputs: busca.
saldoCréditos de notas e limitesARead-onlyIdempotentInspect
Quantidade de notas disponíveis, preço por nota, ambiente e teto diário. O nome técnico saldo é mantido por compatibilidade.
Inputs: no named parameters.
salvar_tomadorSalvar tomadorCDestructiveInspect
Salva/atualiza um tomador frequente (ex.: "salva a Shopee como tomador").
Inputs: razao (required), doc, pais, tipo.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Brazil NFS-e service invoices for AI agents via Focus NFe and NFe.io. Stateless, never stores data.
Issue and manage Brazilian service invoices (NFS-e) by chatting with your agent, platform-hosted, no
Issue and manage Brazilian fiscal documents: NF-e for goods, NFS-e for services.
Issue Brazilian service invoices (NFS-e) via Emissor Nacional, no digital certificate
Related MCP Servers
AlicenseNot gradedqualityCmaintenanceEnables AI assistants to issue, track, and cancel Brazilian NFS-e service invoices through Emissor Nacional without a digital certificate, while managing company credentials, customers, and services. It includes previews and confirmation safeguards for actions with real tax effect.MIT- AlicenseAqualityDmaintenanceEnables AI assistants to interact with Brazilian electronic invoices (NF-e, NFC-e, NFS-e) via Nuvem Fiscal API, including CNPJ lookup, invoice issuance, cancellation, and PDF generation.161MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to issue, query, and cancel Brazilian NF-e and NFS-e invoices through natural language, handling authentication and communication with the Focus NFe tax provider. Includes a simulation mode for testing the full invoice workflow without a provider token.52 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables querying issued electronic service invoices (NFS-e) from the Brazilian Federal Revenue via natural language, providing read-only access to official invoice data.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.