mcp server

fiscal

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

Description as published by the maintainer. Source

• version 1.0.0
• active

active — Most recent push to the repository was 2026-06-12.

What this server can do

34 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

arquivo_baixar(Chaves, ChaveNF, FileType, Base64Logo, TipoDocumentoFiscal)

Baixa o arquivo (XML ou PDF/DANFE) de uma NF-e/NFC-e/NFS-e por chave de acesso. Retorna conteúdo em base64.

arquivo_baixar_evento(ChaveNF, NuProtocolo, TipoArquivo)

Baixa o arquivo de um evento (CC-e, cancelamento, manifestação, encerramento) por chave de acesso + número sequencial. Retorna conteúdo em base64.

arquivo_baixar_periodo(Type, DtFim, Chaves, DtInicio, TipoNota, cpfCnpjs, Situacoes, incluirCCe, TipoAmbiente, JuntarArquivosPDF, aplicarPlanoAjustes)

Exporta múltiplos arquivos (XML/PDF) de um período em um único ZIP base64. Útil para backup, contabilidade ou auditoria.

cadastro_consultar(uf, cpfCnpjIe)

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.

cliente_consultar(Uf, Termo, Fontes, Limite, Offset, TipoBusca, IncluirInativas)

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.

cliente_criar(Id, Ie, Im, Nome, Email, CpfCnpj, Endereco, Telefone, IndicadorIe, ConsumidorFinal)

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. Required: CpfCnpj, Nome.

cliente_editar(Id, Ie, Im, Nome, Email, CpfCnpj, Endereco, Telefone, IndicadorIe, ConsumidorFinal)

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). Required: CpfCnpj, Nome.

cte_desacordo(Chave, Observacao, TipoAmbiente, NumeroSequencial)

Registra desacordo do tomador com um CT-e recebido (evento tipo 4 do CT-e). Prazo: 45 dias da emissão.

cte_emitir(Cfop, Lote, Carga, Modal, Serie, Codigo, Numero, Retira, Imposto, Servico, TipoCte, Tomador, DtEmissao, Expedidor, Remetente, Observacao, Destinatario, TipoAmbiente, ModeloDocumento, NaturezaOperacao, IdentificadorInterno)

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. Required: ModeloDocumento, TipoAmbiente, TipoCte, Cfop, NaturezaOperacao, Modal, Carga, Servico.

dce_emitir(Lote, Itens, Serie, Codigo, Numero, UfFisco, Remetente, ValorTotal, XOrgaoFisco, Destinatario, TipoAmbiente, TipoEmitente, SiteMarketplace, CnpjTransportadora, IdentificadorInterno, ModalidadeTransporte, DeclaracaoCrimeTributario, InformacoesComplementares, DeclaracaoContribuinteICMS, InformacoesAdicionaisFisco)

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. Required: TipoAmbiente, Remetente, Destinatario, Itens, DeclaracaoContribuinteICMS, DeclaracaoCrimeTributario.

evento_cancelar(ChaveNF, DataEvento, NumeroNFSe, TipoAmbiente, Justificativa, TipoDocumento, NumeroProtocolo, NumeroSequencial, CodCancelamentoNFSe, CpfCnpjRemetenteDCe)

Cancela um documento fiscal autorizado (NF-e, NFC-e, NFS-e, CT-e, MDF-e, DC-e). 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). Required: ChaveNF, Justificativa, TipoAmbiente, TipoDocumento.

evento_carta_correcao(ChaveNF, Correcao, Correcoes, TipoAmbiente, NumeroSequencial)

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. Required: TipoAmbiente, ChaveNF.

evento_inutilizar(Serie, TipoAmbiente, Justificativa, NumeracaoFinal, ModeloDocumento, NumeracaoInicial)

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. Required: TipoAmbiente, ModeloDocumento, Serie, Justificativa, NumeracaoInicial, NumeracaoFinal.

evento_manifestar(Chave, TipoAmbiente, Justificativa, NumeroSequencial, TipoManifestacao)

Registra a manifestação do destinatário sobre uma NF-e. TipoEvento: 0=ciência da operação, 1=confirmação da operação, 2=desconhecimento, 3=operação não realizada. Required: Chave, TipoAmbiente, TipoManifestacao.

fci_gerar(Produtos, Transmitir, ValidarCodigos)

Gera o arquivo FCI (Ficha de Conteúdo de Importação) requerido para produtos com conteúdo importado em operações interestaduais.

health

Verifica a saúde da API BrasilNFe (status, timestamp, versão). Não recebe parâmetros.

imposto_calcular(Count, Capacity)

Simula o cálculo de impostos (ICMS, PIS, COFINS, IPI, ST) sobre uma lista de produtos sem emitir nota. Útil para precificação.

mdfe_emitir(lote, peso, Aereo, serie, valor, codigo, numero, seguros, Aquaviario, Rodoviario, modalidade, observacao, DataEmissao, Ferroviario, percursoUfs, tipoAmbiente, tipoEmitente, carregamentos, ufCarregamento, observacaoFisco, descarregamentos, ufDescarregamento, produtoPredominante, identificadorInterno)

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. Required: tipoAmbiente, tipoEmitente, ufCarregamento, ufDescarregamento, modalidade, valor, peso.

mdfe_encerrar(chave, protocolo, tipoAmbiente, numeroSequencial)

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. Required: tipoAmbiente, chave.

nfe_emitir(Lote, Serie, Codigo, Numero, Cliente, Entrega, Exporta, Cobranca, Produtos, Retencoes, Finalidade, Observacao, Pagamentos, TpNFDebito, Transporte, DataEmissao, EnviarEmail, TpNFCredito, CalcularIBPT, NFReferencia, TipoAmbiente, Intermediador, Justificativa, ConsumidorFinal, ModeloDocumento, ObservacaoFisco, DataEntradaSaida, NaturezaOperacao, IndicadorPresenca, IdentificadorInterno)

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. Required: IndicadorPresenca, NaturezaOperacao, ModeloDocumento, Finalidade, TipoAmbiente, Produtos.

nfe_emitir_complementar(CFOP, Lote, Serie, Codigo, Numero, Cliente, Cobranca, Produtos, Observacao, Transporte, NFReferencia, TipoAmbiente, ObservacaoFisco, TipoComplemento, NaturezaOperacao, ImpostoComplementar)

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.

nfe_previsualizar(Base64Xml, TipoEnvio, notaFiscal, TipoArquivo, mostrarTarjaPreVisualizacao)

Gera o DANFE em PDF como pré-visualização, sem enviar para a SEFAZ. Útil para conferência visual antes de emitir.

nfenercom_emitir(serie, numero, energia, produtos, situacao, comunicao, dataEmissao, destinatario, tipoAmbiente, modeloDocumento, valorTotalFatura, identificadorInterno)

Envia a NF-EnerCom (Nota Fiscal de Energia Comercializada) para autorização na SEFAZ. Required: modeloDocumento, tipoAmbiente, valorTotalFatura, dataEmissao, destinatario, produtos.

nfenercom_gerar_arquivo(ano, mes, notas, tipoGeracao, tipoAmbiente)

Gera o arquivo da Nota Fiscal de Energia (NF-EnerCom). Pré-requisito para nfenercom_emitir. Required: tipoGeracao, tipoAmbiente.

nfse_consultar(Rps, codLote)

Consulta status e dados de uma NFS-e já enviada por número, série e ambiente.

nfse_emitir(Lote, nFSInfo, TipoAmbiente)

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. Required: TipoAmbiente, nFSInfo.

nota_listar(DtFim, DtInicio, TipoAmbiente, TipoDocumentoFiscal, IdentificadorInterno)

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.

produto_consultar(Termo, Limite, Offset, TipoBusca)

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.

produto_criar(Id, Ean, Ncm, Cest, Codigo, Descricao, FatorConversao, QuantidadeEstoque, ValorUnitarioVenda, UnidadeMedidaVendaSigla, UnidadeMedidaCompraSigla)

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. Required: Codigo, Descricao, UnidadeMedidaVendaSigla, ValorUnitarioVenda.

produto_editar(Id, Ean, Ncm, Cest, Codigo, Descricao, FatorConversao, QuantidadeEstoque, ValorUnitarioVenda, UnidadeMedidaVendaSigla, UnidadeMedidaCompraSigla)

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). Required: Codigo, Descricao, UnidadeMedidaVendaSigla, ValorUnitarioVenda.

sefaz_status(ModeloDocumento)

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.

tributacao_consultar(Cfop, Tipo, Termo, Limite, Offset)

Lista regras de tributacao da empresa (CFOP, CST, aliquotas ICMS/PIS/COFINS/IPI/IBS/CBS). Filtra por Tipo (1=NFe, 2=NFCe, 3=Energia/Comunicacao), 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.

tributacao_criar(Id, Cfop, Tipo, CstIpi, CstPis, AliqCbs, AliqIpi, AliqPis, ApiCode, CstIcms, AliqIcms, AutoAliq, AliqIbsUf, CstCofins, CstIbsCbs, Descricao, AliqCofins, AliqIbsMun, Observacao, AliqReducao, AliqDiferimento, EnquadramentoIpi, CodBeneficioFiscal)

Cadastra uma nova regra de tributacao (CFOP + CSTs + aliquotas). Tipo 1=NFe, 2=NFCe, 3=Energia/Comunicacao. CstIbsCbs e obrigatorio (Reforma Tributaria). Required: Cfop, Descricao.

tributacao_editar(Id, Cfop, Tipo, CstIpi, CstPis, AliqCbs, AliqIpi, AliqPis, ApiCode, CstIcms, AliqIcms, AutoAliq, AliqIbsUf, CstCofins, CstIbsCbs, Descricao, AliqCofins, AliqIbsMun, Observacao, AliqReducao, AliqDiferimento, EnquadramentoIpi, CodBeneficioFiscal)

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. Required: Cfop, Descricao.

Last successful function declaration observed on 2026-08-13. Source: https://api.brasilnfe.com.br/services/Mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://api.brasilnfe.com.br/services/Mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Repository — https://github.com/BrasilNFe/brasilnfe-mcp
• Website — https://www.brasilnfe.com.br/mcp
• Remote endpoint (streamable-http) — https://api.brasilnfe.com.br/services/Mcp

Related, by what their authors tagged them

• MCP Fiscal Brasil — last commit 2026-08-04, shares brasil, fiscal, nfe
  Ferramentas fiscais brasileiras: CNPJ, NF-e, IBS/CBS, ICMS, Simples Nacional, NCM/CFOP. Sem API key.
• com.somosvelora/velora — last commit 2026-08-05, shares fiscal
  Hosted Argentine commerce MCP: real AFIP invoicing, MercadoPago, logistics, catalog & WhatsApp.
• Conta Azul MCP — last commit 2026-06-23, shares brasil, nfe
  Conta Azul ERP MCP — sales, customers, finance and NF-e via OAuth 2.0. Read + write, 35 tools.
• Banco MCP — last commit 2026-05-15, shares brasil
  Brazilian Open Finance MCP — 30+ banks (Itaú, Nubank, etc.) to Claude/Cursor. Read-only.
• io.github.edsonvmendes/miniframe-tools — last commit 2026-07-24, shares brasil
  Brazilian tools for agents: Pix codes, CEP, CNPJ + web capture and PDF. Pay per call.
• Peil — last commit 2026-07-24, shares invoicing
  Log hours, draft invoices and check where you stand — finance for Dutch freelancers.
• Norman MCP Server — last commit 2026-08-05, shares invoicing
  AI-powered bookkeeping and tax filing for entrepreneurs at the heart of the European economy.
• Frihet ERP — last commit 2026-08-06, shares invoicing
  AI-native ERP MCP: ES/EU fiscal compliance (VeriFactu/TicketBAI/Facturae), invoicing, tax, banking
• io.github.causa-prima-ai/scribo — last commit 2026-06-12, shares invoicing
  EN 16931-compliant e-invoices: XRechnung, ZUGFeRD, Factur-X, Peppol BIS, Facturae or US PDF. Free.
• EZ@Work — last commit 2026-06-19, shares invoicing
  Manage clients, projects, time, and invoices in EZ@Work — business management for freelancers.

These share tags the maintainers applied themselves, such as brasil, fiscal, nfe, tax. Common tags like "mcp" or "ai" are ignored for this: agreeing with six hundred other projects is not a similarity.

This is not a recommendation and not a test result. It is a map of what the authors said their work is about.

How the author describes it

Topics the maintainer set on GitHub: ai, brasil, brazilian-invoice, claude, cte, fiscal, invoicing, llm, mcp, mdfe, model-context-protocol, nfe, nfse, sefaz, tax.