Pular para o conteúdo
Fiscal

mcp-nfe-br

MCP aberto para NF-e/NFC-e, NFS-e Nacional e CT-e: gera, assina, valida e envia à SEFAZ, sem intermediário. Também valida CPF e CNPJ.

Ainda não testado

Link conferido em 03/11/2026, sem instalar.

Atenção: Desde a versão 0.6, o projeto gera, assina e envia NF-e, NFC-e, NFS-e e CT-e para a SEFAZ ou para o ambiente nacional. Nota de produção tem efeito fiscal real. Para só explorar, ligue o modo somente leitura (BR_READ_ONLY=1).

Mantido por cmendezs, não pelo Estuda com IA. Nunca cole chave de API, token ou senha no chat.

O que faz

Segundo a descrição do repositório, o projeto é neutro em relação a fornecedores: monta, valida e assina localmente e fala direto com a SEFAZ, sem intermediário. Na verificação de 03/11/2026, o README informava a versão 0.6.5, com geração de NF-e/NFC-e (modelos 55 e 65) e NFS-e Nacional, assinatura ICP-Brasil, validação pelo XSD e envio à SEFAZ ou ao ambiente nacional (ADN). O CT-e (modelo 57) tem escopo limitado nesta versão: só modal rodoviário.

Para quem

Pessoas desenvolvedoras e empresas que querem emitir notas a partir de um agente sem depender de um provedor intermediário. Exige certificado digital e conhecimento fiscal.

Como usar

Segundo o README do repositório, o servidor pede Python 3.11 ou mais novo e não precisa de credenciais para rodar. No Claude Desktop, adicione ao claude_desktop_config.json:

{
  "mcpServers": {
    "nfe-br": {
      "command": "uvx",
      "args": ["mcp-nfe-br"]
    }
  }
}

Para explorar sem risco, o README indica a variável BR_READ_ONLY=1, que desliga todas as ferramentas que enviam ou cancelam documentos. O ambiente (produção ou homologação) é escolhido em cada chamada.

Pedido de exemplo (nosso, usa a ferramenta br__validate_cpf):

Este CPF é válido? 123.456.789-09

Descrição e passo a passo baseados no que a página oficial ou o repositório informava na data de verificação. Não instalamos este MCP ainda. Confira a documentação antes de usar e comece em ambiente de testes.

Veja também