Fiscal brasileiro agora fala MCP.
A NFE.io é a primeira API fiscal brasileira com servidor Model Context Protocol oficial hospedado. Não é um llms.txt publicado pra marcar posição. É uma stack de 4 camadas, arquitetada desde o primeiro commit pra ser lida e operada por agentes de IA.
Em 2026, API sem MCP é API sem interface pra IA.
MCP (Model Context Protocol) é o padrão — criado pela Anthropic, adotado por OpenAI, Google, JetBrains, Cursor, Windsurf — que conecta agentes de IA a ferramentas externas. Quem não fala MCP em 2026 é quem não falava HTTP em 1996. Não é acessório. É infraestrutura.
"Enquanto API fiscal tradicional publicou um arquivo llms.txt pra ser considerada AI-ready, a NFE.io publicou uma plataforma inteira pensada pra agentes — incluindo servidor MCP oficial hospedado em mcp.nfe.io."
— Briefing interno NFE.io, 2026-04-154 camadas. Pensadas em ordem inversa: do que o agente precisa, não do que é mais fácil de construir.
Cada camada reduz ambiguidade pro LLM. Docs em Markdown puro evitam scraping. SDK com CLAUDE.md elimina chute. OpenAPI versionado blinda contra alucinação. Servidor MCP remove a necessidade do agente escrever código HTTP.
Markdown onde o agente precisa
417 páginas de documentação servidas em .md puro. Botão "Copiar como Markdown" em cada URL. Pipeline in-house converte MDX, Tabs, iframes e imagens pra MD limpo. Cole a doc inteira no prompt — zero ruído de HTML.
SDK TypeScript que o LLM entende
Pacote nfe-io@3.1.0 — zero runtime deps, só fetch nativo. Discriminated unions pro retorno 201 síncrono vs 202 assíncrono. 7 classes de erro tipadas. CLAUDE.md no root com instruções nativas pra Claude Code. Skill publicada que ativa sozinha quando detecta nfe-io no projeto.
OpenAPI como fonte única da verdade
14 specs YAML públicas — NFSe, NFe produto, NFe consumidor, CTe, CNPJ, CPF, endereços, cálculo de impostos. Tipos do SDK auto-gerados das specs: impossível divergir. Agente lê spec, entende contrato, gera chamada correta.
Servidor MCP oficial · mcp.nfe.io
Última camada da stack. Agente não precisa mais ler doc, importar SDK, escrever código HTTP. Conecta direto em https://mcp.nfe.io/mcp, descobre as tools, chama. 3 transportes: hosted (Cloudflare Workers), stdio via npx @nfe/mcp-server, container OCI em ghcr.io.
Schemas Zod validados. Descrições escritas pra agentes saberem quando chamar (e quando não).
Anotações MCP corretas: read-only e idempotentes pra consultas, destrutivas pra emissão. Agente de IA responsável pede confirmação antes de operações que gerem documento fiscal real.
Emite NFS-e pra empresa cadastrada. Por padrão faz polling (5 min, backoff exponencial) até estado terminal — Issued ou IssueFailed. Aceita waitForCompletion=false pra retorno imediato com invoiceId pra consultar depois.
input: { companyId, cityServiceCode, description, servicesAmount,
borrower: { federalTaxNumber, name, email?, address? },
deductions?, issRate?, ...11 campos opcionais de imposto }
Lista NFS-e de uma empresa com filtros de data (issuedBegin, issuedEnd, createdBegin, createdEnd) e paginação por offset.
Consulta estado de processamento de uma nota. Retorna flowStatus, isComplete, isFailed e o objeto completo da invoice.
Dados da Receita Federal via serviço de consulta NFE.io: razão social, nome fantasia, situação cadastral (Active/Suspended/Cancelled/Null), CNAE, sócios, endereço enriquecido por CEP.
CEP → logradouro, bairro, cidade (com código IBGE), UF. Fornece o city.code necessário pra preencher o endereço do tomador em uma emissão de NFS-e.
API fiscal tradicional vs API fiscal AI-native.
Mesmo problema — emitir nota fiscal eletrônica. Caminho do agente até a nota emitida, drasticamente diferente.
API fiscal tradicional
- Doc renderizada por JavaScript — agente precisa fazer scraping ou ler devtools
- SDK sem tipagem moderna: agente chuta estrutura de retorno, erra em produção
- Sem CLAUDE.md nem skill pré-construída — cada dev tem que educar o agente do zero
- Sem servidor MCP: agente escreve código HTTP, arranja auth, trata erro, faz polling manualmente
- Marketing AI-ready = publicou um arquivo llms.txt de 200 linhas
- Integração da 1ª tool: dias a semanas
NFE.io AI-native
- 417 páginas em Markdown puro, URL .md direta, botão "Copy as Markdown"
- SDK TypeScript v3, zero deps, discriminated unions, 7 erros tipados, 126★
- CLAUDE.md no SDK + skill Claude pré-construída auto-ativa no projeto
- Servidor MCP oficial em mcp.nfe.io — agente conecta com 1 linha de config
- Stack de 4 camadas arquitetada desde o primeiro commit
- Integração da 1ª tool: 30 segundos
Sua próxima decisão de fornecedor fiscal é uma decisão de arquitetura AI.
A API fiscal que seu time vai integrar nos próximos 5 anos precisa ser legível pelo agente que vai escrever 80% desse código. A NFE.io já é.