\n\n\n \n \n\n\n# Brasil NFe MCP\n\n**Servidor MCP fiscal brasileiro - sua IA emite NF-e, NFC-e, NFS-e, CT-e, MDF-e e DC-e.**\n\n[Site](https://www.brasilnfe.com.br) - [Documentação MCP](https://www.brasilnfe.com.br/mcp) - [Demo ao vivo](https://www.brasilnfe.com.br/ai/) - [Painel](https://api.brasilnfe.com.br)\n\n[English](README.en.md) - Português\n\n
\n\n---\n\n## O que é\n\nO **Brasil NFe MCP** é o primeiro servidor MCP (Model Context Protocol) que expõe a infraestrutura fiscal brasileira inteira como ferramentas, recursos e prompts pra qualquer cliente compatível com MCP - Claude Desktop, Cursor, Windsurf, VS Code Copilot, Zed, Continue.dev, JetBrains, ou sua própria aplicação.\n\nPlugue o servidor no seu cliente MCP e o agente de IA passa a **emitir nota fiscal por linguagem natural** direto na conversa - \"emite uma NFC-e de R$ 89,90 pro CPF tal\" - e o documento vai pra SEFAZ. A IA descobre as tools sozinha, monta o payload pelo schema e traduz erros da SEFAZ pra linguagem clara.\n\n## REST API ou MCP?\n\nOs dois são produtos de primeira linha da Brasil NFe e expõem a **mesma** infraestrutura fiscal - mesmo backend SEFAZ, mesmo SLA, mesmo suporte humano. A escolha é pelo tipo de integração, não pela qualidade:\n\n| Use a **[API REST](https://www.brasilnfe.com.br/docs)** quando | Use o **MCP** quando |\n|---|---|\n| Você tem ERP, sistema de gestão ou app próprio com fluxo de emissão já definido | Quer um assistente IA, copilot ou agente decidindo quando e como emitir |\n| O processamento é em lote, agendado ou movido por evento de fila/webhook | O fluxo é conversacional - usuário (ou agente) no loop dirigindo cada passo |\n| A integração é determinística e você tem controle pixel-perfect da UI/UX | O cliente quer plugar Claude / Cursor / Copilot do contador direto na operação |\n| Volume alto, paralelismo otimizado, contratos de payload estáveis | Sessão interativa, exploratória, ad-hoc por linguagem natural |\n\n> Os dois conversam com o mesmo backend - **dá pra ter o ERP integrado via REST e ao mesmo tempo plugar a IA do contador no MCP**. Quando uma rota nova entra na API REST, ela já vira tool MCP automaticamente. Roadmap fiscal unificado, dois canais de consumo.\n\n## Endpoint público\n\n```\nhttps://api.brasilnfe.com.br/services/Mcp\n```\n\n| Recurso | Método | Caminho |\n|---|---|---|\n| JSON-RPC | `POST` | `/services/Mcp` |\n| SSE stream | `GET` | `/services/Mcp` |\n| Encerrar sessão | `DELETE` | `/services/Mcp` |\n| Discovery | `GET` | `/.well-known/mcp` |\n| Health | `GET` | `/services/Mcp/info` |\n\n- **Transport:** Streamable HTTP\n- **Spec:** MCP `2025-06-18`\n- **Auth:** Bearer token (`Authorization: Bearer `)\n- **Rate-limit:** 60 requisições/minuto por token (default)\n\n## O que está exposto\n\n### 30+ tools em 8 categorias\n\n| Categoria | Tools | O que faz |\n|---|---|---|\n| **NF-e / NFC-e** | `nfe_emitir`, `nfe_emitir_complementar`, `nfe_previsualizar` | Emite produto B2B (modelo 55) ou cupom de varejo (modelo 65), gera DANFE prévio |\n| **NFS-e** | `nfse_emitir`, `nfse_consultar` | Emite e consulta nota de serviço (5.500+ regras municipais embutidas) |\n| **CT-e** | `cte_emitir`, `cte_desacordo` | Emite conhecimento de transporte, registra desacordo do tomador |\n| **MDF-e** | `mdfe_emitir`, `mdfe_encerrar` | Emite manifesto de carga, encerra ao fim do transporte |\n| **DC-e** | `dce_emitir` | Emite declaração de conteúdo (PF/MEI) |\n| **NF-EnerCom** | `nfenercom_gerar_arquivo`, `nfenercom_emitir` | Emite NF de energia comercializada |\n| **Eventos fiscais** | `evento_cancelar`, `evento_carta_correcao`, `evento_manifestar`, `evento_inutilizar` | Cancela, corrige (CC-e), manifesta destinatário, inutiliza numeração |\n| **Consultas SEFAZ** | `sefaz_status`, `cadastro_consultar`, `nota_listar`, `imposto_calcular` | Status do serviço, IE, listagem de notas, simulador de impostos |\n| **Cadastros** | `cliente_consultar/criar/editar`, `produto_consultar/criar/editar`, `tributacao_consultar/criar/editar` | CRUD completo de clientes, produtos e regras tributárias (com fallback Receita Federal) |\n| **Arquivos** | `arquivo_baixar`, `arquivo_baixar_evento`, `arquivo_baixar_periodo` | Baixa XML/PDF individual ou ZIP do período |\n| **Auxiliares** | `fci_gerar`, `health` | Gera FCI (conteúdo importado), health-check |\n\n### 5 resources (URI scheme `brasilnfe://`)\n\n- `brasilnfe://empresa/atual` - snapshot da empresa logada\n- `brasilnfe://nfe/{chave}/xml` - XML autorizado\n- `brasilnfe://nfe/{chave}/danfe` - DANFE em PDF\n- `brasilnfe://evento/{chave}/{seq}` - evento por sequencial\n- `brasilnfe://recebidas/{periodo}` - notas recebidas no período\n\n### 5 prompts prontos\n\n- `emitir_nfe_simples` - fluxo guiado de emissão NF-e\n- `cancelar_nota` - cancelamento com validação de prazo\n- `diagnostico_emissao` - checagem completa antes de emitir\n- `relatorio_periodo` - relatório fiscal do período\n- `carta_correcao` - fluxo de CC-e com validação de campos permitidos\n\n## Quick start\n\n### 1. Pegue seu token\n\nCrie uma conta gratuita em [brasilnfe.com.br](https://www.brasilnfe.com.br) e copie o token no [painel](https://api.brasilnfe.com.br). Modo homologação é grátis - você emite documentos de teste à vontade sem nada ir pra SEFAZ de produção.\n\n### 2. Configure seu cliente MCP\n\nPega o arquivo correto em [`examples/`](examples/) e cola na config do seu cliente:\n\n- [Claude Desktop](examples/claude-desktop.json)\n- [Cursor](examples/cursor.json)\n- [Windsurf](examples/windsurf.json)\n- [VS Code Copilot](examples/vscode-copilot.json)\n- [Zed](examples/zed.json)\n- [cURL puro (JSON-RPC)](examples/curl.md)\n\nSubstitua `SEU_TOKEN_AQUI` pelo token real e reinicie o cliente.\n\n### 3. Fala com a IA\n\n```\n\"Liste o status da SEFAZ pra SP.\"\n\"Consulte o CNPJ 39.658.743/0001-99.\"\n\"Emite uma NFC-e de R$ 89,90 pro consumidor com CPF 123.456.789-00.\"\n\"Cancela a chave 35..., justificativa: erro de digitação no valor.\"\n```\n\nPronto. A IA descobre as tools sozinha, pede o que falta, valida, monta o payload, envia pra SEFAZ, e te entrega chave + protocolo + XML + PDF.\n\n## Demo sem cadastro\n\nAbra **[brasilnfe.com.br/ai](https://www.brasilnfe.com.br/ai/)** e converse com o assistente fiscal direto no navegador. Não envia pra SEFAZ de produção, mas mostra o fluxo completo com DANFE renderizado em tempo real ao lado do chat.\n\n## Boas práticas\n\n- **Sempre rode em homologação (`tipoAmbiente: 2`) antes de produção.** Documento de teste tem CNPJ permitido e numeração separada - zero risco fiscal.\n- **Consulte cliente/produto/tributação antes de criar.** As tools `*_consultar` evitam duplicatas e dão à IA o contexto pra reusar cadastros existentes.\n- **Confirme operações destrutivas.** Cancelamento e inutilização são irreversíveis - a IA já é instruída a confirmar, mas verifique no seu fluxo.\n- **Feche sessões idle.** `DELETE /services/Mcp` libera quota mais cedo.\n- **Auditoria sai automática.** Todas as chamadas MCP ficam logadas no painel da sua empresa por 5 anos (LGPD-compliant).\n\n## Suporte\n\n- **Documentação:** [brasilnfe.com.br/mcp](https://www.brasilnfe.com.br/mcp)\n- **Demo ao vivo:** [brasilnfe.com.br/ai](https://www.brasilnfe.com.br/ai/)\n- **WhatsApp:** [+55 (31) 9 7168-5947](https://wa.me/5531971685947) (horário comercial)\n- **E-mail:** contato@brasilnfe.com.br (24/7)\n- **LGPD/DPO:** dpo@brasilnfe.com.br\n\n## Sobre\n\nMantido pela **[Brasil NFe LTDA](https://www.brasilnfe.com.br)** (CNPJ 39.658.743/0001-99), fundada em 2019 em Ipatinga/MG por Maxsuel Lima. Especialista em automação fiscal brasileira: 6 documentos fiscais cobertos, 5.500+ regras municipais NFS-e, 543 códigos SEFAZ embutidos, PCI DSS, e suporte humano 24/7.\n\n## Licença\n\n[MIT](LICENSE) - você pode usar, modificar e distribuir livremente este repositório (configs, exemplos e docs). O servidor MCP em si é serviço operado pela Brasil NFe LTDA - veja [Termos de Uso](https://www.brasilnfe.com.br/termos) e [Política de Privacidade](https://www.brasilnfe.com.br/privacidade).\n",
"bytes": 8084,
"sha": "9a058d6fb50dbc131bc76f130f48855f8163d2b30411e20efe0b346785812893",
"repo_slug": "brasilnfe/brasilnfe-mcp",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_br_com_brasilnfe_fiscal_250f4ce9/readme"
}
![\"Brasil](\"./assets/logo-brasilnfe-branca.png\"){kind=logo}
\n