NestDaddy

Fiscal

br.com.brasilnfe/fiscal · v1.0.0

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

Connect Remote server

Terminal
claude mcp add --transport http fiscal https://api.brasilnfe.com.br/services/Mcp --header "Authorization: Bearer <YOUR_API_KEY>"
~/.cursor/mcp.json
{
  "mcpServers": {
    "fiscal": {
      "url": "https://api.brasilnfe.com.br/services/Mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "fiscal": {
      "type": "http",
      "url": "https://api.brasilnfe.com.br/services/Mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
Claude Desktop
Settings > Connectors > Add custom connector
URL: https://api.brasilnfe.com.br/services/Mcp

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools 36 found in our last check

  • nfe_emitir

    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íncron…

  • nfe_emitir_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.

  • nfe_previsualizar

    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 ped…

  • nfcom_emitir

    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 co…

  • nfse_emitir

    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.

  • nfse_consultar

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

  • cte_emitir

    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.

  • cte_desacordo

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

  • mdfe_emitir

    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

    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.

  • dce_emitir

    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.

  • gnre_emitir

    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 GN…

  • gnre_consultar

    Consulta uma GNRE pelo Id ou pelo identificador interno: situação, linha digitável, PIX copia e cola e o PDF oficial em base64.

  • gnre_configuracao

    Lista as receitas que a UF aceita na GNRE e os campos que cada uma exige (documento de origem, referência, valores, campos adicionais).

  • evento_cancelar

    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 U…

  • evento_carta_correcao

    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_manifestar

    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).

  • evento_inutilizar

    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.

  • sefaz_status

    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.

  • cadastro_consultar

    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 ES…

  • cliente_consultar

    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…

  • cliente_criar

    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

    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…

  • produto_consultar

    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 To…

  • produto_criar

    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

    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 p…

  • tributacao_consultar

    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 2…

  • tributacao_criar

    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).

  • tributacao_editar

    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.

  • nota_listar

    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.

  • imposto_calcular

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

  • arquivo_baixar

    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

    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

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

  • fci_gerar

    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.

Headers

NameDescription
Authorization
Optional
Bearer TOKEN da empresa. Obtenha no painel em https://api.brasilnfe.com.br

Details

Endpointhttps://api.brasilnfe.com.br/services/Mcp (Streamable HTTP)
First published12 Jun 2026
Last updated12 Jun 2026
Registry namebr.com.brasilnfe/fiscal

More other servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.