emissaoja · NFS-e
Server Details
Issue Brazilian service invoices (NFS-e) via Emissor Nacional, no digital certificate
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 16 tools
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.
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.
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.
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 toolsacompanhar_operacaoAcompanhar operaçãoBRead-onlyInspect
Estado de uma operação (cancelamento): processando, concluida ou falhou (com o erro).
Inputs: operacao_id (required).
acompanhar_pedidoAcompanhar pedido de emissãoARead-onlyInspect
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-eADestructiveInspect
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)AIdempotentInspect
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 ReceitaARead-onlyInspect
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)AIdempotentInspect
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-eAIdempotentInspect
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 emitidasARead-onlyInspect
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çosBRead-onlyInspect
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)ARead-onlyInspect
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 empresaARead-onlyInspect
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 pendentesARead-onlyInspect
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 fiscaisAIdempotentInspect
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 credencialARead-onlyInspect
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çoARead-onlyInspect
Diz se o emissaoja está no ar e como está o motor fiscal. Sem chave.
Inputs: no named parameters.
validar_cnpjValidar CNPJARead-onlyInspect
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
Issue and manage Brazilian fiscal documents: NF-e for goods, NFS-e for services.
Issue Brazilian service invoices (NFS-e Nacional) from your AI, with preview and confirmation.
Notas fiscais eletrônicas brasileiras: consulta, análise, manifestação e emissão de NFS-e.
Brazil NFS-e service invoices for AI agents via Focus NFe and NFe.io. Stateless, never stores data.
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- AlicenseNot gradedqualityDmaintenanceAllows consultation of NFS-e (electronic service invoices) from the Brazilian Federal Revenue official source, with a single read-only tool.MIT
- AlicenseAqualityCmaintenanceEnables 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.10Apache 2.0
- AlicenseNot gradedqualityDmaintenanceProvides read-only consultation of Rio de Janeiro's electronic service invoices (NFS-e) from official sources, with pay-per-use credits.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.