Skip to main content
Glama

Server Details

Issue Brazilian service invoices (NFS-e Nacional) from your AI, with preview and confirmation.

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
ChatGPT
–
Claude
NotaMCP

TDQS

A3.7/5.0

Scored across 15 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count5/5

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.

Completeness4/5

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 tools
cancelar_notaCancelar uma notaA
Destructive
Inspect

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 produtoA
Destructive
Inspect

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-eA
Destructive
Inspect

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 notaA
Read-onlyIdempotent
Inspect

Situação de uma nota desta conta (status, número, chave de acesso, erro).

Inputs: nota_id (required).

consultar_nota_produtoConsultar nota de produtoB
Read-onlyIdempotent
Inspect

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 recentesA
Read-onlyIdempotent
Inspect

Ú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 notasC
Read-onlyIdempotent
Inspect

Histórico de notas da conta, com filtros opcionais.

Inputs: limite, status, competencia.

listar_notas_produtoListar notas de produtoC
Read-onlyIdempotent
Inspect

Últimas NF-e ou NFC-e da conta, da mais nova para a mais antiga.

Inputs: tipo (required), limite, status, ambiente.

listar_tomadoresListar tomadores salvosA
Read-onlyIdempotent
Inspect

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 limitesA
Read-onlyIdempotent
Inspect

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 tomadorC
Destructive
Inspect

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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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 npm
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources