# fiscal MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/br-com-brasilnfe-fiscal
- Repository: https://github.com/BrasilNFe/brasilnfe-mcp
- Website: https://www.brasilnfe.com.br/mcp

## Install
- Endpoint: https://api.brasilnfe.com.br/services/Mcp
- Auth: Not captured

## Setup notes
- Remote header: Authorization
- Remote endpoint: https://api.brasilnfe.com.br/services/Mcp
- Header: Authorization

## Tools
- nfe_emitir (Emitir NF-e ou NFC-e) - 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. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- nfe_emitir_complementar (Emitir NF-e complementar) - 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. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- nfe_previsualizar (Pré-visualizar DANFE) - Gera o DANFE em PDF como pré-visualização, sem enviar para a SEFAZ. Útil para conferência visual antes de emitir. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- nfenercom_gerar_arquivo (Gerar arquivo NF-EnerCom) - Gera o arquivo da Nota Fiscal de Energia (NF-EnerCom). Pré-requisito para nfenercom_emitir. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- nfenercom_emitir (Emitir NF-EnerCom) - Envia a NF-EnerCom (Nota Fiscal de Energia Comercializada) para autorização na SEFAZ. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- nfse_emitir (Emitir NFS-e (serviços)) - 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. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- nfse_consultar (Consultar NFS-e) - Consulta status e dados de uma NFS-e já enviada por número, série e ambiente. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- cte_emitir (Emitir CT-e) - 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. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- cte_desacordo (Registrar desacordo de CT-e) - Registra desacordo do tomador com um CT-e recebido (evento tipo 4 do CT-e). Prazo: 45 dias da emissão. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- mdfe_emitir (Emitir MDF-e) - 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. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- mdfe_encerrar (Encerrar MDF-e) - 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. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- dce_emitir (Emitir DC-e) - 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. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- evento_cancelar (Cancelar documento fiscal) - 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). Endpoint: https://api.brasilnfe.com.br/services/Mcp
- evento_carta_correcao (Enviar Carta de Correção (CC-e)) - 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. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- evento_manifestar (Manifestar destinatário) - 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. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- evento_inutilizar (Inutilizar numeração) - 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. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- sefaz_status (Status do serviço SEFAZ) - 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. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- cadastro_consultar (Consultar Inscrição Estadual (IE) na SEFAZ) - 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. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- cliente_consultar (Consultar cliente/destinatario por CNPJ, CPF, IE ou nome) - 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. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- cliente_criar (Cadastrar novo cliente (destinatario/fornecedor/transportadora)) - 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. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- cliente_editar (Editar cliente cadastrado) - 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). Endpoint: https://api.brasilnfe.com.br/services/Mcp
- produto_consultar (Consultar produto por codigo, NCM, GTIN ou descricao) - 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. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- produto_criar (Cadastrar novo produto) - 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. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- produto_editar (Editar produto cadastrado) - 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). Endpoint: https://api.brasilnfe.com.br/services/Mcp
- tributacao_consultar (Consultar regras de tributacao) - 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. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- tributacao_criar (Cadastrar nova regra de tributacao) - Cadastra uma nova regra de tributacao (CFOP + CSTs + aliquotas). Tipo 1=NFe, 2=NFCe, 3=Energia/Comunicacao. CstIbsCbs e obrigatorio (Reforma Tributaria). Endpoint: https://api.brasilnfe.com.br/services/Mcp
- tributacao_editar (Editar regra de tributacao) - 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. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- nota_listar (Listar notas fiscais) - 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. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- imposto_calcular (Simular cálculo de impostos) - Simula o cálculo de impostos (ICMS, PIS, COFINS, IPI, ST) sobre uma lista de produtos sem emitir nota. Útil para precificação. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- arquivo_baixar (Baixar XML ou PDF do documento) - Baixa o arquivo (XML ou PDF/DANFE) de uma NF-e/NFC-e/NFS-e por chave de acesso. Retorna conteúdo em base64. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- arquivo_baixar_evento (Baixar XML ou PDF de evento) - Baixa o arquivo de um evento (CC-e, cancelamento, manifestação, encerramento) por chave de acesso + número sequencial. Retorna conteúdo em base64. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- arquivo_baixar_periodo (Exportar arquivos do período) - Exporta múltiplos arquivos (XML/PDF) de um período em um único ZIP base64. Útil para backup, contabilidade ou auditoria. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- fci_gerar (Gerar FCI) - Gera o arquivo FCI (Ficha de Conteúdo de Importação) requerido para produtos com conteúdo importado em operações interestaduais. Endpoint: https://api.brasilnfe.com.br/services/Mcp
- health (Health-check) - Verifica a saúde da API BrasilNFe (status, timestamp, versão). Não recebe parâmetros. Endpoint: https://api.brasilnfe.com.br/services/Mcp

## Resources
- brasilnfe://empresa/atual - Dados da empresa autenticada Informações da empresa do token: razão social, CNPJ, regime tributário, IE, UF, estado de contingência. Use antes de emitir para confirmar o emitente correto. MIME type: application/json

## Prompts
- emitir_nfe_simples - Emitir NF-e simples Guia o assistente para emitir uma NF-e (modelo 55) com um produto, calculando impostos automaticamente pelo grupo tributário. Arguments: cnpjCliente, descricaoProduto, valor, ambiente, naturezaOperacao
- cancelar_nota - Cancelar nota fiscal Guia o assistente para cancelar uma NF-e/NFC-e/CT-e/MDF-e/DC-e ou NFS-e. Arguments: chave, numeroNFSe, justificativa
- diagnostico_emissao - Diagnóstico de emissão Verifica se a empresa está apta a emitir documentos fiscais agora (SEFAZ, certificado, contingência). Arguments: uf
- relatorio_periodo - Relatório de notas do período Gera um relatório com NF-e/NFC-e emitidas em um período, com totais e contagens. Arguments: dataInicio, dataFim, modeloDocumento
- carta_correcao - Enviar Carta de Correção (CC-e) Guia o assistente para enviar uma CC-e em uma NF-e ou CT-e já autorizada. Arguments: chave, correcao

## Metadata
- Owner: br.com.brasilnfe
- Version: 1.0.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jun 12, 2026
- Source: https://registry.modelcontextprotocol.io