Skip to main content
Glama

Server Details

Brazilian fiscal MCP server - issue NF-e, NFC-e, NFS-e, CT-e, MDF-e and DC-e via SEFAZ.

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
Repository
BrasilNFe/brasilnfe-mcp
GitHub Stars
0
Server Listing
brasilnfe-mcp
ChatGPT
–
Claude
–

TDQS

B3.4/5.0

Scored across 38 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count2/5

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.

Completeness4/5

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 tools
arquivo_baixarBaixar XML ou PDF do documentoB
Read-onlyIdempotent
Inspect

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

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íodoA
Read-only
Inspect

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

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

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 cadastradoA
DestructiveIdempotent
Inspect

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

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

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

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

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)A
Destructive
Inspect

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çãoA
Destructive
Inspect

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árioA
Destructive
Inspect

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

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 GNREB
Read-only
Inspect

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

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

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

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

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

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

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

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

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

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

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

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

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)B
Destructive
Inspect

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

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

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 cadastradoA
DestructiveIdempotent
Inspect

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

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

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 tributacaoA
DestructiveIdempotent
Inspect

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

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Model 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.
      22
      63 PyPI
      1
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP 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
    • A
      license
      Not graded
      quality
      D
      maintenance
      Read-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
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.