fiscal
Server Details
Brazilian fiscal MCP server - issue NF-e, NFC-e, NFS-e, CT-e, MDF-e and DC-e via SEFAZ.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- BrasilNFe/brasilnfe-mcp
- GitHub Stars
- 0
- Server Listing
- brasilnfe-mcp
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 38 tools
Most tools are clearly separated by fiscal document type and action, and descriptions explicitly distinguish similar-looking pairs such as cliente_consultar vs cadastro_consultar and nfe_emitir vs nfe_emitir_complementar. Some consultation-style tools (nfse_consultar vs nota_listar) and many document/event variants still require reading descriptions, but there are no true duplicates.
The set follows a mostly consistent Portuguese resource_action convention, e.g. nfe_emitir, produto_consultar, evento_cancelar, mdfe_encerrar. Minor deviations are health (English, no action pattern) and state-style names like mdfe_nao_encerrados, but overall the pattern is predictable.
With 38 tools, the surface is very heavy and exposes many separate operations across NF-e, NFC-e, NFS-e, CT-e, MDF-e, DC-e, NFCom, GNRE, events, arquivos, cadastros and tributação. Much of the breadth is justified by the fiscal domain, but families such as consult/criar/editar and event actions increase cognitive load and could be consolidated.
The server covers the main fiscal lifecycle: issuance, preview, cancellation, correction, manifestation, inutilização, file download, GNRE, customer/product registration and tax rules. Gaps remain in generic consultation for some document types (CT-e, MDF-e, DC-e, NFCom), delete operations for customer/product/tax rules, and nota_listar is limited to NF-e/NFC-e/NFS-e.
Available Tools
38 toolsarquivo_baixarBaixar XML ou PDF do documentoBRead-onlyIdempotentInspect
Baixa o arquivo (XML ou PDF/DANFE) de uma NF-e/NFC-e/NFS-e por chave de acesso. Retorna conteúdo em base64.
Inputs: Chaves, ChaveNF, FileType, Base64Logo, +1 more.
arquivo_baixar_eventoBaixar XML ou PDF de eventoARead-onlyIdempotentInspect
Baixa o arquivo de um evento (CC-e, cancelamento, manifestação, encerramento) por chave de acesso + número sequencial. Retorna conteúdo em base64.
Inputs: ChaveNF, NuProtocolo, TipoArquivo.
arquivo_baixar_periodoExportar arquivos do períodoARead-onlyInspect
Exporta múltiplos arquivos (XML/PDF) de um período em um único ZIP base64. Útil para backup, contabilidade ou auditoria.
Inputs: Type, DtFim, Chaves, DtInicio, +8 more. Returns: Error, Avisos, Quantidade, Base64FilesCompacted
cadastro_consultarConsultar Inscrição Estadual (IE) na SEFAZARead-onlyIdempotentInspect
Consulta a Inscrição Estadual (IE) de um contribuinte na SEFAZ estadual (mundo NF-e/ICMS), por CNPJ/CPF/IE + UF. ATENÇÃO: muitas UFs NÃO oferecem este serviço (ex: RJ) e prestadores de serviço normalmente NÃO têm IE - nesses casos a IE não vem, e ISSO NÃO SIGNIFICA QUE O CNPJ ESTEJA INATIVO. Quando a SEFAZ não retorna e o documento é CNPJ, há fallback automático na Receita Federal (campo 'fonte'='receita') trazendo razão social, situação cadastral e endereço - sempre leia o campo 'mensagem'. Para apenas saber se um CNPJ está ativo ou pegar seus dados cadastrais (sem precisar da IE), prefira cliente_consultar.
Inputs: uf, cpfCnpjIe. Returns: ie, fonte, status, Contato, +16 more
cliente_consultarConsultar cliente/destinatario por CNPJ, CPF, IE ou nomeARead-onlyIdempotentInspect
Pesquisa unificada de cliente/fornecedor. Tenta primeiro o cadastro local da empresa logada e, se nao achar e o termo for um CNPJ valido, consulta a BrasilAPI (Receita Federal) - razao social, endereco, situacao cadastral. E a tool CORRETA pra saber se um CNPJ esta ativo e pegar seus dados (razao social, endereco) - nao confunda com cadastro_consultar, que so traz Inscricao Estadual (IE) da SEFAZ. Use ANTES de pedir CNPJ ao usuario; geralmente o usuario informa nome ou apelido (ex: 'TNT', 'Correios'). Obs: consulta na Receita so funciona por CNPJ - CPF nao tem base publica. Para obter a Inscricao Estadual (operacao com ICMS), use cadastro_consultar. PAGINACAO: Limite default 10 (max 50). Use Offset pra ir alem - o retorno traz TotalGeral. Se TotalGeral > matches retornados, peça mais paginas em vez de inventar/agrupar.
Inputs: Uf, Termo, Fontes, Limite, +3 more. Returns: Avisos, Limite, Offset, Matches, +5 more
cliente_criarCadastrar novo cliente (destinatario/fornecedor/transportadora)AInspect
Cadastra um novo Cliente no sistema da empresa logada (CNPJ ou CPF, razao social, endereco, IE). Use depois de cliente_consultar quando o usuario confirmar que quer salvar o cadastro. Se ja existir cliente com mesmo CpfCnpj devolve erro com Id existente - use cliente_editar.
Inputs: Nome (required), CpfCnpj (required), Id, Ie, +6 more. Returns: Id, Ok, Erro, Cliente
cliente_editarEditar cliente cadastradoADestructiveIdempotentInspect
Atualiza dados de um Cliente existente no cadastro. O campo Id e obrigatorio. ATENCAO: envie o payload COMPLETO - campos omitidos sao zerados, nao preservados. Para edicao parcial, faca cliente_consultar primeiro e mande os dados existentes mais o que muda. Valida ownership por UserCreate (cliente tem que pertencer ao usuario logado) e por empresa (IdEmpresa tem que ser a logada, 0 ou null - se for outra empresa sua, troque antes).
Inputs: Nome (required), CpfCnpj (required), Id, Ie, +6 more. Returns: Id, Ok, Erro, Cliente
cte_desacordoRegistrar desacordo de CT-eADestructiveInspect
Registra desacordo do tomador com um CT-e recebido (evento tipo 4 do CT-e). Prazo: 45 dias da emissão.
Inputs: Chave, Observacao, TipoAmbiente, NumeroSequencial. Returns: Error, Avisos, Status, DsEvento, +7 more
cte_emitirEmitir CT-eBDestructiveInspect
Emite CT-e (Conhecimento de Transporte Eletrônico). Requer serviço CT-e habilitado no cadastro da empresa e certificado digital A1 ou A3 configurado.
Inputs: Cfop (required), Carga (required), Modal (required), Servico (required), +21 more. Returns: chave, erros, serie, avisos, +5 more
dce_emitirEmitir DC-eBDestructiveInspect
Emite DC-e (Declaração de Conteúdo Eletrônica) para transporte de itens não-fiscais por pessoa física ou MEI. Requer serviço DC-e habilitado no cadastro.
Inputs: Itens (required), Remetente (required), Destinatario (required), TipoAmbiente (required), +16 more. Returns: chave, erros, serie, avisos, +6 more
evento_cancelarCancelar documento fiscalADestructiveInspect
Cancela um documento fiscal autorizado (NF-e, NFC-e, NFS-e, CT-e, MDF-e, DC-e, NFCom). Informe a chave de 44 dígitos e a justificativa (mínimo 15 caracteres). Para NFS-e use TipoDocumento=1 e informe NumeroNFSe ao invés de chave. Prazo SEFAZ NF-e: 24h após autorização (algumas UFs mais). NFCom: até 120h após o último dia do mês da autorização.
Inputs: ChaveNF (required), TipoAmbiente (required), Justificativa (required), TipoDocumento (required), +6 more. Returns: Error, Avisos, Status, DsEvento, +7 more
evento_carta_correcaoEnviar Carta de Correção (CC-e)ADestructiveInspect
Envia Carta de Correção (CC-e) para uma NF-e ou CT-e já autorizada (evento tipo 2). Não pode corrigir: valores, datas de emissão/saída, partes envolvidas (CNPJ/CPF), regimes tributários ou número/série do documento. Limite: 20 CC-e por NF-e.
Inputs: ChaveNF (required), TipoAmbiente (required), Correcao, Correcoes, +1 more. Returns: Error, Avisos, Status, DsEvento, +7 more
evento_inutilizarInutilizar numeraçãoADestructiveInspect
Inutiliza uma faixa de numeração não utilizada na SEFAZ. Útil quando há quebra de sequência por erro de emissão. Não pode ser desfeito. Operação rara - confirme com o usuário antes.
Inputs: Serie (required), TipoAmbiente (required), Justificativa (required), NumeracaoFinal (required), +2 more. Returns: Error, Avisos, Status, DsEvento, +7 more
evento_manifestarManifestar destinatárioADestructiveInspect
Registra a manifestação do destinatário sobre uma NF-e. TipoManifestacao: 1=confirmação da operação, 2=ciência da operação, 3=desconhecimento, 4=operação não realizada (exige Justificativa com 15+ caracteres).
Inputs: Chave (required), TipoAmbiente (required), TipoManifestacao (required), Justificativa, +1 more. Returns: Error, Avisos, Status, DsEvento, +7 more
fci_gerarGerar FCIAInspect
Gera o arquivo FCI (Ficha de Conteúdo de Importação) requerido para produtos com conteúdo importado em operações interestaduais.
Inputs: Produtos, Transmitir, ValidarCodigos.
gnre_configuracaoRegras da GNRE por UFBRead-onlyIdempotentInspect
Lista as receitas que a UF aceita na GNRE e os campos que cada uma exige (documento de origem, referência, valores, campos adicionais).
Inputs: Uf, Receita, TipoAmbiente. Returns: Uf, erros, avisos, status, +2 more
gnre_consultarConsultar GNREBRead-onlyInspect
Consulta uma GNRE pelo Id ou pelo identificador interno: situação, linha digitável, PIX copia e cola e o PDF oficial em base64.
Inputs: Id, IncluirPdf, TipoAmbiente, IdentificadorInterno. Returns: status: 1 - Guia gerada; 2 - Rejeitada (ver erros); 3 - Processando no Portal G…
gnre_emitirGerar GNREADestructiveInspect
Gera a GNRE (guia de ICMS para outra UF, ex.: DIFAL ou ICMS-ST de uma NF-e) no Portal GNRE. O portal processa em segundo plano: o retorno vem com status 3 e o resultado sai em gnre_consultar. Consulte gnre_configuracao antes para saber os campos que a UF exige. Requer serviço GNRE habilitado no cadastro.
Inputs: Itens, TipoAmbiente, UfFavorecida, DataPagamento, +1 more. Returns: status: 1 - Guia gerada; 2 - Rejeitada (ver erros); 3 - Processando no Portal G…
healthHealth-checkARead-onlyIdempotentInspect
Verifica a saúde da API BrasilNFe (status, timestamp, versão). Não recebe parâmetros.
Inputs: no named parameters.
imposto_calcularSimular cálculo de impostosBRead-onlyIdempotentInspect
Simula o cálculo de impostos (ICMS, PIS, COFINS, IPI, ST) sobre uma lista de produtos sem emitir nota. Útil para precificação.
Inputs: Count, Capacity. Returns: Error, Total, Avisos, Impostos
mdfe_emitirEmitir MDF-eCDestructiveInspect
Emite MDF-e (Manifesto Eletrônico de Documentos Fiscais), agrupando vários CT-e/NF-e em um único transporte. Obrigatório para transportadores com vários DFs no mesmo veículo.
Inputs: peso (required), valor (required), modalidade (required), tipoAmbiente (required), +20 more. Returns: Error, chave, Avisos, numero, +6 more
mdfe_encerrarEncerrar MDF-eADestructiveInspect
Encerra um MDF-e já autorizado (evento tipo 3). Obrigatório ao final de cada transporte. Sem encerramento, novos MDF-e podem ser bloqueados pela SEFAZ.
Inputs: chave (required), tipoAmbiente (required), uf, protocolo, +3 more. Returns: Error, Avisos, Status, DsEvento, +7 more
mdfe_incluirIncluir condutor ou NF-e no MDF-eADestructiveInspect
Inclui num MDF-e autorizado e ainda não encerrado um condutor (nome e CPF, evento 110114) ou NF-e (só modelo 55, com o município de carregamento e o de descarregamento de cada nota, evento 110115). Um evento por chamada: informe 'condutor' ou 'carregamento' + 'descarregamentos'.
Inputs: chave (required), tipoAmbiente (required), condutor, protocolo, +3 more. Returns: Error, Avisos, Status, DsEvento, +7 more
mdfe_nao_encerradosConsultar MDF-e não encerradosARead-onlyIdempotentInspect
Consulta na SEFAZ os MDF-e autorizados e ainda não encerrados do CNPJ da empresa, inclusive os emitidos por outro sistema. Devolve chave e protocolo de cada um, para encerrar com mdfe_encerrar.
Inputs: tipoAmbiente (required). Returns: Error, Avisos, motivo, status, +2 more
nfcom_emitirEmitir NFComADestructiveInspect
Emite a NFCom (modelo 62, Nota Fiscal Fatura de Serviço de Comunicação Eletrônica) de provedor de internet, TV por assinatura ou telefonia: assinante, itens com cClass e fatura. Requer serviço NFCom habilitado e a empresa credenciada na SEFAZ. Cancelamento por evento_cancelar com a chave.
Inputs: Itens (required), Assinante (required), Destinatario (required), TipoAmbiente (required), +16 more. Returns: chave, erros, serie, avisos, +6 more
nfe_emitirEmitir NF-e ou NFC-eADestructiveInspect
Emite uma NF-e (modelo 55) ou NFC-e (modelo 65) na SEFAZ. Use modeloDocumento=55 para NF-e (B2B com destinatário CPF/CNPJ) ou modeloDocumento=65 para NFC-e (consumidor final). Retorna chave de acesso (44 dígitos), número, protocolo, status e XML/DANFE em base64. Operação síncrona (pode levar 5-30s). Use tipoAmbiente=2 (homologação) para testes. TRANSMITE DE VERDADE: só chame depois que o usuário aprovou a pré-visualização final (nfe_previsualizar) e confirmou a emissão; envie confirmacaoUsuario=true (conexões OAuth são recusadas sem ele).
Inputs: Produtos (required), Finalidade (required), TipoAmbiente (required), ModeloDocumento (required), +34 more. Returns: Error, Avisos, ReturnNF, Base64Xml, +1 more
nfe_emitir_complementarEmitir NF-e complementarADestructiveInspect
Emite uma NF-e complementar referenciando uma NF-e já autorizada. Usado para complementar valores, impostos ou itens (finalidade=2). Informe a chave da nota original em NFReferencia.
Inputs: CFOP, Lote, Serie, Codigo, +12 more. Returns: Error, Avisos, ReturnNF, Base64Xml, +1 more
nfe_previsualizarPré-visualizar DANFEARead-onlyIdempotentInspect
Gera o DANFE em PDF e o XML como pré-visualização, sem enviar para a SEFAZ. Envie a nota completa em 'notaFiscal' (mesmo formato de nfe_emitir) com TipoEnvio=1 e TipoArquivo=2 (PDF + XML juntos). O resultado abre num painel ao lado da conversa: chame de novo a cada alteração pedida pelo usuário (CFOP, itens, destinatário, valores) para o painel refletir a nota atual. Erros de validação voltam em 'Error'/'Avisos'.
Inputs: cte, dce, mdfe, nfse, +5 more. Returns: Error, Avisos, Status, Base64Xml, +1 more
nfse_consultarConsultar NFS-eBRead-onlyIdempotentInspect
Consulta status e dados de uma NFS-e já enviada por número, série e ambiente.
Inputs: Rps, codLote. Returns: Lote, Error, Notas, Avisos, +9 more
nfse_emitirEmitir NFS-e (serviços)BDestructiveInspect
Emite NFS-e (Nota Fiscal de Serviços Eletrônica). Cada município brasileiro tem regras e webservices próprios - confira o município emissor antes. Pode usar Portal Nacional NFS-e ou prefeitura específica conforme cadastro da empresa.
Inputs: nFSInfo (required), TipoAmbiente (required), Lote. Returns: Lote, Error, Notas, Avisos, +9 more
nota_listarListar notas fiscaisARead-onlyIdempotentInspect
Lista NF-e/NFC-e/NFS-e emitidas ou recebidas pela empresa em um intervalo de datas. Suporta filtros por chave, número, status e tipo.
Inputs: DtFim, DtInicio, TipoAmbiente, TipoParticipacao, +2 more. Returns: Error, Notas, Avisos
produto_consultarConsultar produto por codigo, NCM, GTIN ou descricaoARead-onlyIdempotentInspect
Pesquisa produto no cadastro da empresa logada. Aceita codigo interno, NCM (8 digitos), GTIN/EAN (8/12/13/14 digitos) ou descricao parcial. Use ANTES de criar produtos novos para evitar duplicatas. PAGINACAO: Limite default 20 (max 50). Use Offset pra ir alem - o retorno traz TotalGeral. Se TotalGeral > matches retornados, peça mais paginas em vez de inventar/agrupar.
Inputs: Termo, Limite, Offset, TipoBusca. Returns: Avisos, Limite, Offset, Matches, +4 more
produto_criarCadastrar novo produtoBInspect
Cadastra um novo Produto na empresa logada. Validacao de duplicata por Codigo. NCM aceito com 7 ou 8 digitos (zero-pad automatico). EAN/GTIN validado por digito verificador.
Inputs: Codigo (required), Descricao (required), ValorUnitarioVenda (required), UnidadeMedidaVendaSigla (required), +7 more. Returns: Id, Ok, Erro, Produto
produto_editarEditar produto cadastradoADestructiveIdempotentInspect
Atualiza um Produto existente. Id obrigatorio. ATENCAO: envie o payload COMPLETO - campos omitidos sao zerados. Faca produto_consultar antes pra ter os dados atuais, depois envie tudo + o que muda. Valida ownership por UserCreate (produto tem que pertencer ao usuario logado) e por empresa (IdEmpresa tem que ser a logada ou 0 - se for outra empresa sua, troque antes).
Inputs: Codigo (required), Descricao (required), ValorUnitarioVenda (required), UnidadeMedidaVendaSigla (required), +7 more. Returns: Id, Ok, Erro, Produto
sefaz_statusStatus do serviço SEFAZARead-onlyIdempotentInspect
Consulta o status do serviço de autorização da SEFAZ para uma UF e ambiente. Use antes de uma emissão em lote ou quando suspeitar de instabilidade.
Inputs: ModeloDocumento. Returns: erros, Versao, avisos, status, +6 more
tributacao_consultarConsultar regras de tributacaoARead-onlyIdempotentInspect
Lista regras de tributacao da empresa (CFOP, CST, aliquotas ICMS/PIS/COFINS/IPI/IBS/CBS). Filtra por Tipo (1=NFe, 2=NFCe, 3=Comunicacao/NFCom), CFOP especifico ou termo na descricao. Use antes de criar nota fiscal pra LLM saber quais tributos aplicar. PAGINACAO: Limite default 20 (max 50). Use Offset pra ir alem - o retorno traz TotalGeral. Se TotalGeral > matches retornados, peça mais paginas em vez de inventar/agrupar.
Inputs: Cfop, Tipo, Termo, Limite, +1 more. Returns: Total, Avisos, Limite, Offset, +2 more
tributacao_criarCadastrar nova regra de tributacaoBInspect
Cadastra uma nova regra de tributacao (CFOP + CSTs + aliquotas). Tipo 1=NFe, 2=NFCe, 3=Comunicacao/NFCom (CodClassificacao = cClass de 7 digitos). CstIbsCbs e obrigatorio (Reforma Tributaria).
Inputs: Cfop (required), Descricao (required), Id, Tipo, +19 more. Returns: Id, Ok, Erro, Tributacao
tributacao_editarEditar regra de tributacaoADestructiveIdempotentInspect
Atualiza uma regra de tributacao existente. Id obrigatorio. ATENCAO: envie o payload COMPLETO - campos omitidos sao zerados. Faca tributacao_consultar antes pra ter os dados atuais, depois envie tudo + o que muda. Valida ownership por IdEmpresa.
Inputs: Cfop (required), Descricao (required), Id, Tipo, +19 more. Returns: Id, Ok, Erro, Tributacao
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.
Brazilian e-invoicing (NF-e, NFC-e, NFS-e): issue, cancel and query fiscal documents, plus AP/AR.
Issue Brazilian service invoices (NFS-e) via Emissor Nacional, no digital certificate
Brazilian SEFAZ e-invoices (NF-e, CT-e) issued against your company. A1 cert, DANFE PDF.
Related MCP Servers
- AlicenseAqualityBmaintenanceModel Context Protocol (MCP) server for Brazilian Electronic Invoicing (NF-e / NFC-e, modelo 55/65, schema 4.00). Provides CPF/CNPJ validation tools, with NF-e/NFC-e generation and SEFAZ integration planned.2263 PyPI1Apache 2.0
- AlicenseNot gradedqualityDmaintenanceMCP server to validate Brazilian fiscal documents (NF-e and NFS-e) locally before transmission, offering actionable feedback without requiring certificates or sending data anywhere.MIT
- AlicenseNot gradedqualityDmaintenanceEnables querying official electronic service invoice (NFS-e) data from the Recife city government through a read-only, hosted MCP server with pay-per-use prepaid credits.MIT
- AlicenseNot gradedqualityDmaintenanceRead-only MCP server for querying official SEFAZ GO NFC-e (Brazilian electronic invoice) data via a single tool. Uses pre-paid credits for usage.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.