NFER Lança Servidor MCP Oficial: Emissão de NF-e, Consultas SEFAZ e IA Fiscal no Cursor, Claude e ChatGPT

Temos o orgulho de anunciar o lançamento do Servidor MCP Oficial da NFER (Model Context Protocol), a primeira infraestrutura fiscal do Brasil totalmente integrada ao padrão aberto da Anthropic para agentes de Inteligência Artificial e ambientes de desenvolvimento modernos.

A partir de hoje, desenvolvedores, softwares houses, contadores e empresas podem plugar seus assistentes favoritos — incluindo Cursor IDE, Claude Desktop, Claude Code CLI, Windsurf ou frameworks de agentes autônomos — diretamente aos serviços da SEFAZ, Receita Federal e motor de emissão da NFER em linguagem natural.

Seu Assistente de IA como Copiloto Especialista na Integração da API NFER

Integrar APIs fiscais tradicionalmente sempre foi uma das tarefas mais complexas do desenvolvimento de software: dezenas de campos no XML, cálculos intrincados de ICMS, PIS, COFINS, IBS/CBS, regras de contingência e centenas de códigos de rejeição da SEFAZ.

Com o Servidor MCP conectado ao seu editor, a sua IA ganha conhecimento nativo e ferramentas ativas para guiar você durante 100% da integração da nossa API REST:

• Integração completa do emissor no seu projeto – Peça para a IA estruturar toda a rotina de emissão (rotas, models, preflight e webhook) na linguagem do seu projeto (Node.js, Python, PHP, C#, Go, Java), já adaptada aos endpoints da NFER (/v1/nfe, /v1/nfce, /v1/nfse, /v1/dce);
• Simulação preflight sem queimar numeração – A IA executa a ferramenta simular_preflight_nfe no seu código para auditar alíquotas, CFOPs, NCMs e regras de partilha interestadual (DIFAL) antes de assinar o documento;
• Emissão em homologação instantânea – Teste fluxos de checkout e emissão de NF-e ponta a ponta diretamente pelo chat (emitir_nfe_homologacao) recebendo XML e DANFE PDF para validação;
• Diagnóstico e autocorreção de rejeições SEFAZ – Se a SEFAZ retornar rejeições como cStat 539, 206, 732 ou 806, o assistente consulta diagnosticar_rejeicao_sefaz, explica a causa e corrige o código ou payload automaticamente;
• Auditoria de destinatários no CCC – Consulte a Inscrição Estadual ativa e a regularidade cadastral do cliente direto no webservice nacional da SEFAZ (consultar_cadastro_sefaz_ccc) antes mesmo de enviar o pedido.

Catálogo de Ferramentas Fiscais Disponíveis

O conector MCP da NFER divide suas ferramentas em dois níveis de acesso:

1. Ferramentas Gratuitas e Públicas (Sem necessidade de Chave)

• validar_documento – Validação matemática e estrutural de CPF, CNPJ (inclusive o novo padrão alfanumérico), chave de acesso de 44 dígitos e cálculo de partilha de ICMS (DIFAL/FCP);
• consultar_status_sefaz – Telemetria ao vivo dos webservices autorizadores de todas as 27 Unidades Federativas e contingências SVC-AN e SVC-RS;
• diagnosticar_rejeicao_sefaz – Análise semântica e resolução passo a passo para códigos de erro da SEFAZ (ex: 539, 206, 732, 806) e NFS-e ADN (E0037, E0038);
• consultar_cfop e validar_cfop – Tabela técnica oficial SINIEF v2.10 completa com títulos, descrições, notas explicativas e validação de compatibilidade para contribuintes sem Inscrição Estadual (Regra I08-191);
• consultar_ibge_cidades e consultar_cnae – Busca de códigos municipais (cMun), estados e subclasses de atividade econômica oficiais da Receita Federal;
• consultar_adesao_nfse – Verificação em tempo real de convênio e adesão municipal ao Emissor Nacional de NFS-e (SEFIN / Receita Federal / ADN);
• consultar_indicadores_bacen – Cotação PTAX diária do dólar/euro, taxa Selic meta anual e IPCA acumulado de 12 meses direto do Banco Central;
• classificar_reforma_tributaria – Orientações e enquadramentos da Reforma Tributária (IBS e CBS) conforme a Lei Complementar nº 214/2025;
• gerar_danfe_pdf – Conversão instantânea de qualquer XML de NF-e ou NFC-e autorizado em DANFE PDF formatado de alta qualidade com código de barras;
• consultar_documentacao – Busca semântica e contextual em toda a documentação da API REST da NFER (endpoints, schemas JSON, webhooks HMAC, cancelamento e CC-e);
• obter_guia_integracao – Exemplos prontos e passo a passo de integração nas linguagens TypeScript, Node.js, Python, PHP, C#/.NET ou cURL.

2. Ferramentas Corporativas (Com Company API Key)

• consultar_empresa_emissora – Consulta dos dados cadastrais, CNPJ, Razão Social, Inscrição Estadual, CRT (regime tributário) e ambiente ativo (Homologação ou Produção);
• consultar_cadastro_sefaz_ccc – Consulta oficial CadConsultaCadastro4 para obter Inscrição Estadual ativa, CNPJ e endereço direto no webservice da SEFAZ de qualquer estado;
• consultar_cpf – Consulta de dados cadastrais de pessoa física (Nome completo, Gênero e Data de Nascimento) na base da Receita Federal com tolerância a falhas;
• simular_preflight_nfe – Auditoria e cálculo automático de alíquotas e regras tributárias antes da assinatura digital para evitar rejeições;
• emitir_nfe_homologacao – Transmissão de NF-e para o ambiente de testes oficial da SEFAZ com geração imediata de XML e DANFE sem valor fiscal;
• emitir_nfe_producao – Autorização oficial de NF-e em produção com verificação rigorosa contra alucinações de IA e exigência de autorização explícita (confirmar_emissao_real: true);
• consultar_nota_fiscal – Consulta de status de autorização, chave de acesso de 44 dígitos, protocolo SEFAZ e links de download do XML/DANFE de NF-e, NFC-e, NFS-e ou CT-e;
• consultar_clientes e cadastrar_cliente – Busca, listagem e cadastro ágil de destinatários e tomadores de serviço diretamente pelo chat;
• consultar_produtos e cadastrar_produto – Busca no catálogo de produtos e cadastro com parametrização fiscal (SKU, NCM, CEST, CFOP e alíquotas);
• consultar_saldo_emissao – Consulta de notas emitidas no mês, limite da franquia contratada e saldo de emissões disponíveis na conta.

Como Configurar em Menos de 1 Minuto

Selecione o seu ambiente de desenvolvimento ou cliente MCP abaixo para ver o arquivo de configuração correspondente:

Após salvar a configuração, seu assistente reconhecerá as ferramentas imediatamente. Você pode testar digitando: "Verifique o status da SEFAZ de São Paulo e audite a Inscrição Estadual do CNPJ 00.000.000/0001-91 no CCC".

Exemplos Práticos de Uso no Chat

• Emissão automática pós-checkout: "Crie uma função em TypeScript que recebe o webhook de pedido pago e emite a NF-e na NFER com envio automático de XML e DANFE PDF por e-mail para o cliente."
• Diagnóstico de rejeição SEFAZ: "Minha nota foi rejeitada com cStat 539 (Duplicidade de NF-e). Verifique a última numeração autorizada na SEFAZ e me mostre como corrigir o payload."
• Consulta oficial no cadastro SEFAZ: "Consulte o CNPJ 00.000.000/0001-91 no CCC da SEFAZ de São Paulo e preencha os dados de Inscrição Estadual e endereço para a nota."
• Simulação tributária e DIFAL: "Simule a emissão de uma venda interestadual de SP para o RJ com produto NCM 8471.30.12 e calcule as alíquotas de ICMS e partilha DIFAL antes de assinar."
• Emissão de teste em homologação: "Emita uma NF-e de teste em ambiente de homologação para o cliente de teste e me retorne o link do DANFE PDF para validar o layout de impressão."
• Monitoramento de disponibilidade: "Verifique a telemetria ao vivo da SEFAZ do Rio Grande do Sul e me avise se o serviço está operando normalmente ou em contingência SVC-RS."

Contexto Estruturado: Arquivos llms.txt e llms-full.txt

Ao conectar o seu assistente ao nosso Servidor MCP Oficial, você não precisa configurar nada manualmente nem importar arquivos de contexto — o conector já fornece todas as ferramentas ativas, schemas e rotas da API em tempo real.

Caso esteja utilizando um assistente ou ambiente que ainda não suporte MCP, a NFER também disponibiliza arquivos de contexto estáticos otimizados segundo a especificação aberta /llms.txt.