MCP server

Brasilnfe Fiscal Official

br.com.brasilnfe/fiscal

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

brasilnfe.com.br (verified by the MCP Registry)

Status

Working at last check

Tools

34

Token cost

About 70,581 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http fiscal https://api.brasilnfe.com.br/services/Mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.fiscal]
url = "https://api.brasilnfe.com.br/services/Mcp"

Gemini CLI

{"mcpServers":{"fiscal":{"httpUrl":"https://api.brasilnfe.com.br/services/Mcp"}}}

Cursor

{"mcpServers":{"fiscal":{"url":"https://api.brasilnfe.com.br/services/Mcp"}}}

VS Code

{"servers":{"fiscal":{"type":"http","url":"https://api.brasilnfe.com.br/services/Mcp"}}}

Antigravity

agy mcp add fiscal https://api.brasilnfe.com.br/services/Mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"fiscal","server_url":"https://api.brasilnfe.com.br/services/Mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"fiscal","server_url":"https://api.brasilnfe.com.br/services/Mcp"}

Tools

• arquivo_baixar ~190 tokens
  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 ~222 tokens
  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 ~462 tokens
  Exporta múltiplos arquivos (XML/PDF) de um período em um único ZIP base64. Útil para backup, contabilidade ou auditoria.
• cadastro_consultar ~242 tokens
  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
• cliente_consultar ~352 tokens
  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 so
• cliente_criar ~340 tokens
  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.
• cliente_editar ~386 tokens
  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 t
• cte_desacordo ~147 tokens
  Registra desacordo do tomador com um CT-e recebido (evento tipo 4 do CT-e). Prazo: 45 dias da emissão.
• cte_emitir ~4682 tokens
  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.
• dce_emitir ~1592 tokens
  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.
• evento_cancelar ~747 tokens
  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).
• evento_carta_correcao ~472 tokens
  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.
• evento_inutilizar ~398 tokens
  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.
• evento_manifestar ~387 tokens
  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).
• fci_gerar ~482 tokens
  Gera o arquivo FCI (Ficha de Conteúdo de Importação) requerido para produtos com conteúdo importado em operações interestaduais.
• health ~57 tokens
  Verifica a saúde da API BrasilNFe (status, timestamp, versão). Não recebe parâmetros.
• imposto_calcular ~87 tokens
  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 ~3902 tokens
  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.
• mdfe_encerrar ~282 tokens
  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.
• nfe_emitir ~11288 tokens
  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).
• nfe_emitir_complementar ~8265 tokens
  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 ~25871 tokens
  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 (CFO
• nfenercom_emitir ~1537 tokens
  Envia a NF-EnerCom (Nota Fiscal de Energia Comercializada) para autorização na SEFAZ.
• nfenercom_gerar_arquivo ~1795 tokens
  Gera o arquivo da Nota Fiscal de Energia (NF-EnerCom). Pré-requisito para nfenercom_emitir.
• nfse_consultar ~111 tokens
  Consulta status e dados de uma NFS-e já enviada por número, série e ambiente.
• nfse_emitir ~4227 tokens
  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.
• nota_listar ~328 tokens
  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 ~183 tokens
  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 TotalGer
• produto_criar ~235 tokens
  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.
• produto_editar ~291 tokens
  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
• sefaz_status ~135 tokens
  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 ~209 tokens
  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 Off
• tributacao_criar ~325 tokens
  Cadastra uma nova regra de tributacao (CFOP + CSTs + aliquotas). Tipo 1=NFe, 2=NFCe, 3=Energia/Comunicacao. CstIbsCbs e obrigatorio (Reforma Tributaria).
• tributacao_editar ~352 tokens
  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.

Browse

• PDF tools

Related MCP servers

• Stackin
  Issue and manage Brazilian fiscal documents: NF-e for goods, NFS-e for services.
• SEFAZ CE: Cupom Fiscal Eletrônico (SAT)
  SEFAZ CE: Cupom Fiscal Eletrônico (SAT), official-source lookup. Platform-hosted, pay per query with
• SEFAZ PE: Certidão de Regularidade Fiscal
  SEFAZ PE: Certificate de Regularidade Fiscal, official-source lookup. Platform-hosted, pay per query
• SEFAZ SP: Cupom Fiscal Eletrônico (SAT)
  SEFAZ SP: Cupom Fiscal Eletrônico (SAT), official-source lookup. Platform-hosted, pay per query with
• SEFAZ PE: Certidão de Regularidade Fiscal (Móvel)
  SEFAZ PE: Certificate de Regularidade Fiscal (Móvel), official-source lookup. Platform-hosted, pay p
• SEFAZ SP: Cupom Fiscal Eletrônico (SAT) - Detalhado
  SEFAZ SP: Cupom Fiscal Eletrônico (SAT) - Detalhado, official-source lookup. Platform-hosted, pay pe
• Nota Fiscal
  Issue and manage Brazilian service invoices (NFS-e) by chatting with your agent, platform-hosted, no
• HiveCloud CT-e / MDF-e
  Transportation fiscal-document issuer from Bsoft by nstech (HiveCloud). Query CT-e (freight bill of

Badge for your README

[![AptLynx](https://aptlynx.net/badge/br.com.brasilnfe/fiscal.svg)](https://aptlynx.net/servers/br.com.brasilnfe/fiscal)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents