Skip to main content
Glama

emissaoja · NFS-e

Server Details

Issue Brazilian service invoices (NFS-e) via Emissor Nacional, no digital certificate

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
–

TDQS

A3.8/5.0

Scored across 16 tools

Disambiguation4/5

Most tools target clearly distinct actions: emitir_nota, cancelar_nota, listar_notas, criar_tomador, and the credential/onboarding trio are well separated by descriptions. The only mild overlaps are acompanhar_pedido vs acompanhar_operacao (two async tracking tools) and consultar_cnpj vs validar_cnpj (online lookup vs offline check), which the descriptions do distinguish.

Naming Consistency4/5

Nearly all tools follow a Portuguese verb_noun pattern (emitir_nota, cancelar_nota, listar_notas, criar_tomador, configurar_credencial, responder_perguntas_fiscais). A few read-only tools deviate to noun-only names (minha_empresa, perguntas_fiscais, situacao_credencial, status), which is readable but breaks the pattern.

Tool Count4/5

16 tools is slightly heavy but fits a domain with emission lifecycle, cancellation, credential connection, onboarding questions, and CNPJ/tomador management. Each tool maps to a real workflow step; nothing appears redundant.

Completeness4/5

Core lifecycle is covered: connect credential, onboarding, register tomador, list serviços, emitir, track, list, cancel, and track the cancellation operation. Minor gaps exist: no get-single-nota/DANFSe or XML download, and serviços are read-only (no create/update).

Available Tools

16 tools
acompanhar_operacaoAcompanhar operaçãoB
Read-only
Inspect

Estado de uma operação (cancelamento): processando, concluida ou falhou (com o erro).

Inputs: operacao_id (required).

acompanhar_pedidoAcompanhar pedido de emissãoA
Read-only
Inspect

Estado de um pedido de emissão: na_fila, emitindo, confirmando, autorizada (com numero e chave_acesso), recusada (com motivo) ou incerta. Consulte de novo depois de proxima_consulta_ms enquanto não for terminal.

Inputs: pedido_id (required).

cancelar_notaCancelar NFS-eA
Destructive
Inspect

Cancela uma nota emitida, dentro do prazo do Emissor Nacional. Irreversível: confirme com a pessoa a nota (número, tomador, valor) e o motivo antes. Responde com a operação; acompanhe com acompanhar_operacao (processando → concluida ou falhou).

Inputs: motivo (required), origem (required), nota_id (required), justificativa.

configurar_credencialConectar a empresa (CNPJ e senha do Emissor Nacional)A
Idempotent
Inspect

Conecta a empresa da conta ao Emissor Nacional com o CNPJ e a senha do portal (não é a conta gov.br). A senha é conferida no portal, nunca guardada nem devolvida. Depois o emissaoja lê o cadastro fiscal e traz as notas dos últimos 90 dias. Só use quando a pessoa pedir e informar a senha ela mesma; são no máximo 3 tentativas erradas por dia (regra do portal, para não bloquear a conta da empresa). Responde na hora com a tentativa; acompanhe com situacao_credencial até proximo_passo sair de "aguardar".

Inputs: cnpj (required), senha (required), ciente_ultima_tentativa.

consultar_cnpjConsultar CNPJ na ReceitaA
Read-only
Inspect

Dados cadastrais de um CNPJ na Receita Federal (razão social, situação, CNAEs, endereço, Simples/MEI, sócios com CPF mascarado). Não cria tomador; para emitir para esse CNPJ use criar_tomador.

Inputs: cnpj (required).

criar_tomadorCriar tomador (cliente)A
Idempotent
Inspect

Cadastra um cliente pelo CNPJ (nome e endereço vêm da Receita) ou pelo CPF com o nome completo. Se já existir, devolve o existente (ja_existia). Devolve tipo + id para emitir_nota.

Inputs: documento (required), nome.

emitir_notaEmitir NFS-eA
Idempotent
Inspect

Emite uma nota fiscal de serviço no Emissor Nacional para um tomador já cadastrado (use listar_tomadores ou criar_tomador antes). Faz a prévia e, sem bloqueio, pede a emissão: responde com o pedido (acompanhe com acompanhar_pedido até autorizada, recusada ou incerta). Com bloqueio, devolve o que falta (bloqueios com code, mensagem e acao) em vez de emitir. Passe sempre uma referencia única por nota que a pessoa quer emitir (ex.: "pedido-123"): repetir a mesma referencia devolve o mesmo pedido e nunca emite duas vezes. Confirme com a pessoa tomador, valor e descrição antes de chamar; a nota tem efeito fiscal real.

Inputs: valor (required), tomador_id (required), tomador_tipo (required), descricao, +5 more.

listar_notasListar notas emitidasA
Read-only
Inspect

Notas emitidas (locais e importadas do portal) com número, situação, data, tomador, valor e o par origem + id que cancelar_nota usa. Filtros por período (mes_atual, mes_anterior, ano_atual, 12_meses), situação (todas, emitidas, canceladas) e busca.

Inputs: busca, limite, periodo, situacao.

listar_servicosListar serviçosB
Read-only
Inspect

Serviços cadastrados da empresa (descrição, código nacional de tributação, ISS, principal). emitir_nota usa o principal quando servico_id não é informado.

Inputs: ativos.

listar_tomadoresListar tomadores (clientes)A
Read-only
Inspect

Lista os tomadores (clientes) da empresa, com busca por nome ou documento. Cada um tem tipo (pj/pf), id, nome e documento; o par tipo + id é o que emitir_nota usa.

Inputs: busca, pagina.

minha_empresaMinha empresaA
Read-only
Inspect

A empresa da conta: CNPJ, nome, estado da credencial do Emissor Nacional (ausente, verificando, ativa, congelada), estado do onboarding (configurando, perguntas, pronto…), importação e avisos. Comece por aqui: se a credencial está ausente, a pessoa precisa conectar a empresa (configurar_credencial); se há perguntas, responda-as com responder_perguntas_fiscais.

Inputs: no named parameters.

perguntas_fiscaisPerguntas fiscais pendentesA
Read-only
Inspect

Estágios do onboarding, perguntas que o cadastro fiscal não responde sozinho (alíquota do Simples, regime de apuração) e bloqueios. Responda com responder_perguntas_fiscais.

Inputs: no named parameters.

responder_perguntas_fiscaisResponder as perguntas fiscaisA
Idempotent
Inspect

Grava a alíquota do Simples Nacional (percentual da última apuração, 0 < x ≤ 33) e/ou o regime de apuração (1 = competência, 2 = caixa, 3 = outro). Só com valores que a pessoa informou; nunca invente.

Inputs: reg_ap_trib_sn, aliquota_simples.

situacao_credencialSituação da credencialA
Read-only
Inspect

Estado da credencial e da última tentativa de conexão: estado (verificando, aceita, senha_recusada, portal_indisponivel, bloqueada…) e proximo_passo (aguardar, configurando, pronto, corrigir_senha, tentar_mais_tarde, redefinir_no_portal, suporte). Consulte a cada poucos segundos enquanto for "aguardar".

Inputs: no named parameters.

statusStatus do serviçoA
Read-only
Inspect

Diz se o emissaoja está no ar e como está o motor fiscal. Sem chave.

Inputs: no named parameters.

validar_cnpjValidar CNPJA
Read-only
Inspect

Confere formato e dígitos verificadores de um CNPJ, sem consultar nada. Sem chave.

Inputs: cnpj (required).

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
      A
      quality
      C
      maintenance
      Enables searching, downloading, and querying Brazilian electronic service invoices (NFS-e) through ISSWeb/Fiorilli municipal portals, including XML and PDF retrieval, access-key and CNPJ lookups, and multi-client configuration.
      10
      Apache 2.0
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources