![\"MCP](\"https://raw.githubusercontent.com/DeHor-Labs/mcp-fiscal-brasil/main/assets/banner.svg\")
\n\n \n
\n O único servidor MCP com suporte nativo a NF-e, NFS-e, SPED, eSocial, Simples Nacional e Reforma Tributária 2026 (IBS/CBS) - sem conta, sem chave e sem configuração.\n
\n\n\n ![\"PyPI](\"https://img.shields.io/pypi/v/mcp-fiscal-brasil?color=009c3b&label=PyPI\")
![\"PyPI](\"https://img.shields.io/pypi/dm/mcp-fiscal-brasil?color=009c3b&label=downloads%2Fm%C3%AAs\")
![\"Python](\"https://img.shields.io/badge/python-3.10%2B-002776?logo=python&logoColor=white\"){kind=icon}
![\"CI\"](\"https://github.com/DeHor-Labs/mcp-fiscal-brasil/actions/workflows/ci.yml/badge.svg\"){kind=icon}
\n ![\"Cobertura](\"https://img.shields.io/badge/cobertura-85%25-009c3b?labelColor=002776\"){kind=icon}
![\"License](\"https://img.shields.io/badge/licenca-MIT-FFDF00?labelColor=002776\"){kind=icon}
![\"MCP](\"https://img.shields.io/badge/MCP-compatível-7c3aed\"){kind=icon}
![\"Stars\"](\"https://img.shields.io/github/stars/DeHor-Labs/mcp-fiscal-brasil?style=flat&color=009c3b\")
![\"Issues\"](\"https://img.shields.io/github/issues/DeHor-Labs/mcp-fiscal-brasil?color=FFDF00&labelColor=002776\")
\n 📚 Documentação ·\n Instalação ·\n Ferramentas ·\n Workflows ·\n Roadmap ·\n Contribuindo\n
\n\n---\n\n## Início rápido\n\n```bash\nuvx mcp-fiscal-brasil\n```\n\n> **Para manter sempre atualizado:** `uvx` cacheia a versão instalada. Use `uvx mcp-fiscal-brasil@latest` ou `uvx --refresh mcp-fiscal-brasil` para forçar a versão mais recente do [PyPI](https://pypi.org/project/mcp-fiscal-brasil/).\n\n### Claude Desktop\n\nEdite `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) ou `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n \"mcpServers\": {\n \"fiscal-brasil\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-fiscal-brasil\"]\n }\n }\n}\n```\n\nReinicie o Claude Desktop. As ferramentas fiscais aparecem automaticamente, sem nenhuma chave de API.\n\n---\n\n## Por que mcp-fiscal-brasil e não outros servidores MCP brasileiros?\n\n| Funcionalidade | mcp-fiscal-brasil | mcp-brasil | brasil-data-mcp |\n|---|:---:|:---:|:---:|\n| Foco | Vertical fiscal profunda | Dados públicos gerais | Dados públicos gerais |\n| NF-e: parse, validação, DANFE, assinatura | Sim | Não | Não |\n| SPED/eSocial: análise offline | Sim | Não | Não |\n| Tabelas offline (NCM, CFOP, CNAE) | Sim | Não | Não |\n| Reforma Tributária 2026 (IBS/CBS) | Sim | Não | Não |\n| Simples Nacional/MEI | Sim | Não | Não |\n| Certidão federal/FGTS | Sim (orientação) | Não | Não |\n| Certificado A1 (mTLS SEFAZ) | Sim (opt-in) | Não | Não |\n| Zero-cadastro, zero chave obrigatória | Sim | Parcial (3 APIs exigem chave) | Sim |\n| Tools agênticas de alto nível | Sim (6 tools) | Parcial | Não |\n| Linguagem de implementação | Python | Python | Node.js |\n\n**mcp-brasil** (1.6k stars) e **brasil-data-mcp** cobrem dados públicos gerais - CEP, bancos, feriados, economia. Este projeto faz algo diferente: é uma vertical fiscal, com parsing offline de XML, validação XSD, tabelas de referência embutidas e suporte à Reforma 2026. Focos diferentes, públicos distintos.\n\n---\n\n## O que é\n\n`mcp-fiscal-brasil` conecta assistentes de IA, ERPs, CRMs e automações internas ao universo fiscal brasileiro: **CNPJ, CPF, Simples Nacional, NFe, NFSe, SPED, eSocial, certidões e due diligence de fornecedores**.\n\nEle não tenta ser um catálogo genérico de dados públicos. A proposta é ser uma vertical de produto: transformar consultas fiscais fragmentadas em **tools seguras, composáveis e prontas para agentes**.\n\n### Workflows que vendem sozinho\n\n| Workflow | Tool principal | Resultado |\n|----------|----------------|-----------|\n| Due diligence de fornecedor | `risk_score_supplier` | Score 0-100, risco, fatores e recomendação de contratação |\n| Triagem em lote | `consultar_empresas_lote` | Vários CNPJs em uma chamada, com compliance + score por empresa |\n| Compliance de CNPJ | `analyze_cnpj_compliance` | CNPJ + Simples/MEI + CNAE em relatório acionável |\n| Validação de NFe | `validate_nfe_full` | XML + chave + emissor, com issues estruturadas |\n| Sumário de SPED | `summarize_sped` | Resumo executivo, período, empresa, blocos e inconsistências |\n| Planejamento tributário | `compare_tax_regimes` | Comparativo MEI, Simples, Lucro Presumido e Lucro Real |\n\n---\n\n## 🌎 Demo ao vivo\n\nWeb UI demo hospedada (Render free tier, pode demorar 30s no primeiro acesso pra acordar):\n\n[](https://render.com/deploy?repo=https://github.com/DeHor-Labs/mcp-fiscal-brasil)\n\nVocê pode clicar no botão acima pra hostear sua própria instância em 3 cliques no Render.com.\n\nVeja [docs/getting-started/deploy.md](docs/getting-started/deploy.md) para outras opções (Fly.io, auto-host via Docker).\n\n---\n\n## ✨ Novidades v0.2.x\n\nVersão de evolução com 4 frentes:\n\n- **8 novas fontes de dados**: CNAE, CPF, Simples Nacional, MEI, IBGE, CEP, Empresa consolidada, Certidões\n- **Tools agênticas** (alto nível): `analyze_cnpj_compliance`, `risk_score_supplier`, `consultar_empresas_lote`, `compare_tax_regimes`, `validate_nfe_full`, `summarize_sped`\n- **Múltiplas interfaces**: além do servidor MCP, agora CLI (`mcp-fiscal`), REST API (`mcp-fiscal-api`) com Web UI demo, e wrapper Node.js em preview (`npm-wrapper/`)\n- **Production-grade**: HTTP client com retry exponencial, cache pluggável, rate-limit por host, logs JSON estruturados\n\n```bash\n# CLI standalone\nmcp-fiscal cnpj 12345678000190\nmcp-fiscal compliance 12345678000190\nmcp-fiscal regimes --faturamento 500000 --setor serviços --folha 180000\n\n# REST API + Web UI demo\nmcp-fiscal-api # http://localhost:8000\n\n# Node.js\nimport { analyzeCompliance } from \"mcp-fiscal-brasil\";\n```\n\nVeja [CHANGELOG.md](CHANGELOG.md) para detalhes.\n\n---\n\n## Por que este projeto existe?\n\nO Brasil tem uma das infraestruturas fiscais mais complexas do mundo. São **27 SEFAZs** estaduais, **NFe + NFSe + SPED + eSocial**, milhares de municípios com portais próprios e milhões de empresas tentando manter conformidade fiscal todos os dias.\n\nAntes deste projeto, integrar IA com qualquer dado fiscal brasileiro exigia desenvolvimento customizado, autenticação em múltiplos portais, e conhecimento profundo de cada API governamental. Cada consulta era um projeto.\n\n**MCP Fiscal Brasil** resolve isso em uma linha: instale o servidor, conecte ao seu assistente de IA, e comece a fazer perguntas em linguagem natural. O servidor cuida de tudo, consultando diretamente Receita Federal, BrasilAPI e SEFAZs estaduais.\n\n---\n\n## 🎬 Demonstração\n\n```\nVocê: \"Consulte o CNPJ 00.000.000/0001-91 e liste os sócios\"\n\nIA: Empresa: Banco do Brasil S.A.\n Fundada em: 12/10/1808\n Situação: ATIVA\n CNAE principal: 6422100 - Bancos múltiplos com carteira comercial\n\n Sócios (QSA):\n - União Federal - Sócio-Administrador (60,82%)\n - BNDESPar - Sócio (10,32%)\n```\n\n```\nVocê: \"A chave NFe 35240300623904000197550010000012341234567890 é válida?\"\n\nIA: Chave válida!\n Estado de origem: SP (São Paulo)\n Data de emissão: março/2024\n CNPJ emitente: 00.623.904/0001-97\n Número da nota: 000001234\n Dígito verificador: correto (módulo 11)\n```\n\n```\nVocê: \"A empresa 12.345.678/0001-90 é do Simples Nacional?\"\n\nIA: Sim! Empresa optante do Simples Nacional.\n Data de opção: 01/01/2020\n Modalidade: MEI - Microempreendedor Individual\n```\n\n```\nVocê: \"O SEFAZ de São Paulo está online agora?\"\n\nIA: Status SEFAZ SP: OPERACIONAL\n Serviço de autorização de NFe funcionando normalmente.\n Última verificação: agora.\n```\n\n---\n\n## 🛠 Ferramentas Disponíveis\n\nFerramentas de baixo nível para dados fiscais e ferramentas agênticas de alto nível para decisão operacional.\n\n### Tools agênticas\n\n| Ferramenta | Quando usar |\n|------------|-------------|\n| `analyze_cnpj_compliance` | Relatório consolidado de compliance fiscal de um CNPJ |\n| `risk_score_supplier` | Aprovar, investigar ou recusar fornecedor |\n| `consultar_empresas_lote` | Triar carteira de fornecedores com score e erro por CNPJ |\n| `compare_tax_regimes` | Comparar regimes tributários por cenário |\n| `validate_nfe_full` | Validar uma NFe completa a partir do XML |\n| `summarize_sped` | Transformar SPED em resumo executivo |\n\n### ✅ Ferramentas Funcionais (usáveis agora)\n\nFuncionam 100% sem chaves de API. Instale e use imediatamente.\n\n| Módulo | Ferramenta | Descrição | API |\n|--------|-----------|-----------|-----|\n| CNPJ | `consultar_cnpj` | Dados completos: razão social, sócios, CNAE, endereço | BrasilAPI (grátis) |\n| CNPJ | `consultar_simples_nacional` | Optante Simples/MEI com datas de entrada e exclusão | BrasilAPI (grátis) |\n| NFe | `validar_chave_nfe` | Valida dígito + extrai UF, CNPJ, data, número | Offline |\n| NFe | `consultar_nfe` | Consulta NFe completa pela chave de 44 dígitos | BrasilAPI (grátis) |\n| NFe | `parse_nfe_xml` | Parseia XML bruto de NF-e/NFC-e e retorna dados estruturados | Offline |\n| NFe | `gerar_danfe` | Gera DANFE PDF (A4) a partir do XML de NF-e (mod 55) | Offline |\n| NFe | `validar_assinatura_nfe` | Valida assinatura XMLDSig e extrai dados do certificado | Offline |\n| NFe | `consultar_status_sefaz` | Status real do webservice SEFAZ por estado via NfeStatusServico4 (requer cert A1) | SEFAZ (mTLS) |\n| NFe | `baixar_nfe_distribuicao` | Baixa documentos via NFeDistribuicaoDFe (requer cert A1 local) | SEFAZ (mTLS) |\n| NFe | `manifestar_nfe` | Manifesta destinatario em NF-e via NFeRecepcaoEvento (requer cert A1) | SEFAZ (mTLS) |\n| CPF | `validar_cpf` | Validação de dígito verificador | Offline |\n| SPED | `analisar_sped` | Analisa arquivo EFD/ECD/ECF: período, empresa, erros | Offline |\n| SPED | `listar_registros_sped` | Filtra registros por tipo (C100, E110, etc.) | Offline |\n| eSocial | `listar_eventos_esocial` | Catálogo de eventos filtrável por grupo | Offline |\n| eSocial | `validar_evento_esocial` | Validação básica de estrutura XML | Offline |\n\n---\n\n### 🧭 Ferramentas de Orientação\n\nRetornam URLs e instruções - exigem ação manual nos portais governamentais.\n\n| Módulo | Ferramenta | O que retorna |\n|--------|-----------|--------------|\n| NFSe | `consultar_nfse` | URL do portal NFSe do município + sistema utilizado |\n| Certidões | `consultar_certidao_federal` | URL do e-CAC para emissão de CND federal |\n| Certidões | `consultar_certidao_fgts` | URL do portal Caixa para consulta do CRF |\n\n---\n\n### 🔐 Ferramentas com Certificado A1 (opt-in)\n\nAs tools `baixar_nfe_distribuicao`, `manifestar_nfe` e `consultar_status_sefaz`\nrequerem um certificado digital A1 (`.pfx`/`.p12`). mTLS é exigência de\ntransporte de todo webservice SEFAZ, inclusive a consulta de status - não há\ncomo consultar o status real sem certificado.\n\n- O certificado e a senha **nunca são enviados a nenhum servidor externo**.\n- A autenticação mTLS e a assinatura XMLDSig são feitas localmente.\n- `baixar_nfe_distribuicao` e `manifestar_nfe` recebem o caminho do certificado\n como parâmetro da própria tool (`.pfx`/`.p12` local).\n- `consultar_status_sefaz` (via servidor MCP/API REST) usa o certificado\n configurado nas variáveis de ambiente abaixo, e se conecta ao webservice\n próprio da UF consultada ou ao ambiente virtual (SVRS/SVAN) quando a UF não\n tem infraestrutura própria.\n- As demais tools (parse, DANFE, assinatura, consultas de CNPJ/NFe via\n BrasilAPI) funcionam sem certificado.\n\n**Configuração** (variáveis em `.env` ou secret do provedor de deploy - ver\n`.env.example`):\n\n| Variável | Descrição |\n|----------|-----------|\n| `NFE_CERTIFICADO_PATH` | Caminho absoluto do `.pfx`/`.p12` montado no container |\n| `NFE_CERTIFICADO_SENHA` | Senha do certificado (sempre via gestor de segredos, nunca em `.env` versionado) |\n| `NFE_EMITENTE_CNPJ` | CNPJ do titular do certificado (14 dígitos, opcional) |\n| `NFE_AMBIENTE` | `producao` ou `homologacao` (padrão `producao`) |\n\nSem `NFE_CERTIFICADO_PATH`/`NFE_CERTIFICADO_SENHA`, `consultar_status_sefaz`\nlevanta `FiscalConfigurationError` e o endpoint HTTP `GET /v1/nfe/status-sefaz`\nresponde 503 - o chamador deve tratar isso como \"sem certificado configurado\",\nnão como SEFAZ fora do ar (falha pontual de rede em uma UF especifica, essa\nsim, degrada omitindo a UF em vez de derrubar a chamada). `GET\n/v1/fiscal/certificado/status` informa apenas se há certificado configurado e\nválido (sem titular nem CNPJ - endpoint sem autenticação, não deve permitir\nreconhecimento de identidade), sem nunca expor o arquivo ou a senha.\n\n---\n\n### 🧪 Ferramentas Experimentais\n\nRequerem APIs pagas ou têm cobertura limitada.\n\n| Módulo | Ferramenta | Limitação |\n|--------|-----------|-----------|\n| CNPJ | `listar_cnpjs_por_nome` | Receita Federal não disponibiliza busca por nome em API pública |\n\n---\n\n## 🚀 Instalação\n\nA forma mais simples, sem instalar nada permanentemente:\n\n```bash\nuvx mcp-fiscal-brasil\n```\n\n> **O que é `uvx`?** É o gerenciador de ferramentas do [uv](https://docs.astral.sh/uv/), que baixa e executa pacotes Python em ambiente isolado, sem poluir seu sistema. Se ainda não tem o uv: `curl -LsSf https://astral.sh/uv/install.sh | sh`\n\n> **Mantendo atualizado via PyPI:** use `uvx mcp-fiscal-brasil@latest` ou `uvx --refresh mcp-fiscal-brasil` para forçar a versão mais recente. O `uvx` cacheia localmente, então sem `@latest` você pode continuar numa versão antiga.\n\n---\n\n## ⚙️ Configuração por Cliente MCP\n\nCole o trecho abaixo no arquivo de configuração do seu cliente. **Nenhuma chave de API é necessária.**\n\n### Claude Desktop\n\nEdite `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) ou `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n \"mcpServers\": {\n \"fiscal-brasil\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-fiscal-brasil\"]\n }\n }\n}\n```\n\nReinicie o Claude Desktop. As ferramentas fiscais e agênticas aparecem automaticamente.\n\n### Claude Code (CLI)\n\n```bash\nclaude mcp add fiscal-brasil -- uvx mcp-fiscal-brasil\n```\n\n### Cursor / `.mcp.json`\n\nCrie ou edite `.cursor/mcp.json` (ou `.mcp.json` na raiz do projeto):\n\n```json\n{\n \"mcpServers\": {\n \"fiscal-brasil\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-fiscal-brasil\"]\n }\n }\n}\n```\n\n### VS Code + Continue\n\nAdicione ao `settings.json`:\n\n```json\n{\n \"continue.mcpServers\": {\n \"fiscal-brasil\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-fiscal-brasil\"]\n }\n }\n}\n```\n\n### Docker\n\n```bash\ndocker run --rm -i \\\n -e MCP_FISCAL_LOG_LEVEL=INFO \\\n ghcr.io/dehor-labs/mcp-fiscal-brasil:latest\n```\n\n---\n\n## 🛠 Instalação permanente (alternativa)\n\nPrefere instalar uma vez e manter no PATH?\n\n```bash\n# via pip\npip install mcp-fiscal-brasil\n\n# via uv (recomendado para projetos Python)\nuv add mcp-fiscal-brasil\n```\n\nApós a instalação, os snippets JSON acima funcionam com `\"command\": \"mcp-fiscal-brasil\"` (sem o `uvx`).\n\n### A partir do código-fonte\n\n```bash\ngit clone https://github.com/DeHor-Labs/mcp-fiscal-brasil.git\ncd mcp-fiscal-brasil\npip install -e .\n```\n\n---\n\n## 🔑 Variáveis de Ambiente\n\nTodas as variáveis são opcionais. O servidor funciona sem nenhuma configuração.\n\n| Variável | Descrição | Padrão |\n|----------|-----------|--------|\n| `MCP_FISCAL_LOG_LEVEL` | Nível de log: `DEBUG`, `INFO`, `WARNING` | `INFO` |\n| `BRASILAPI_BASE_URL` | URL base da BrasilAPI (para ambientes customizados) | `https://brasilapi.com.br/api` |\n| `HTTP_TIMEOUT` | Timeout em segundos para chamadas HTTP | `30` |\n\n---\n\n## Modos de Uso\n\nO `mcp-fiscal-brasil` funciona de quatro formas:\n\n| Modo | Para quem | Como |\n|------|-----------|------|\n| **MCP Server** | Usuários de IA (Claude, Cursor, GPT) | Instala e configura no assistente |\n| **SDK Python** | Desenvolvedores de apps fiscais/contábeis | Importa e usa no código |\n| **CLI** | Operação, scripts e automações locais | Usa `mcp-fiscal ...` |\n| **REST API + Web UI** | Integração HTTP e demo pública | Usa `mcp-fiscal-api` |\n\n---\n\n## 🐍 Uso como Biblioteca Python (SDK)\n\nAlém de funcionar como servidor MCP, você pode importar e usar diretamente no seu código Python - sem servidor, sem configuração extra.\n\n### Início Rápido\n\n```python\nimport asyncio\nfrom mcp_fiscal_brasil import FiscalBrasil\n\nasync def main():\n async with FiscalBrasil() as fiscal:\n empresa = await fiscal.consultar_cnpj(\"00.000.000/0001-91\")\n print(empresa[\"razao_social\"]) # Banco do Brasil S.A.\n print(empresa[\"situacao_cadastral\"]) # ATIVA\n\nasyncio.run(main())\n```\n\n### Validações Offline (sem API, instantâneo)\n\n```python\nfrom mcp_fiscal_brasil import FiscalBrasil\n\nfiscal = FiscalBrasil()\n\n# Validações locais - sem chamada de rede\nprint(fiscal.validate_cpf(\"529.982.247-25\")) # True\nprint(fiscal.validate_cnpj(\"11.222.333/0001-81\")) # True / False\nprint(fiscal.validate_chave_nfe(\"3524...44 digitos...\")) # dict com detalhes\n```\n\n### Integração com FastAPI\n\n```python\nfrom fastapi import FastAPI\nfrom mcp_fiscal_brasil import FiscalBrasil\n\napp = FastAPI()\nfiscal = FiscalBrasil()\n\n@app.get(\"/cnpj/{cnpj}\")\nasync def consultar(cnpj: str):\n async with fiscal:\n return await fiscal.consultar_cnpj(cnpj)\n```\n\n### Integração com Django\n\n```python\n# views.py\nimport asyncio\nfrom mcp_fiscal_brasil import FiscalBrasil\nfrom django.http import JsonResponse\n\ndef consulta_cnpj(request, cnpj):\n async def buscar():\n async with FiscalBrasil() as fiscal:\n return await fiscal.consultar_cnpj(cnpj)\n dados = asyncio.run(buscar())\n return JsonResponse(dados)\n```\n\n### Cadastro Automático de Fornecedor (exemplo ERP)\n\n```python\nimport asyncio\nfrom mcp_fiscal_brasil import FiscalBrasil\n\nasync def cadastrar_fornecedor(cnpj: str, db_session):\n async with FiscalBrasil() as fiscal:\n if not fiscal.validate_cnpj(cnpj):\n raise ValueError(\"CNPJ inválido\")\n\n dados = await fiscal.consultar_cnpj(cnpj)\n simples = await fiscal.consultar_simples_nacional(cnpj)\n\n await db_session.execute(\n \"INSERT INTO fornecedores (cnpj, razao_social, simples) VALUES (?, ?, ?)\",\n [cnpj, dados[\"razao_social\"], simples[\"optante\"]]\n )\n```\n\n### Validação em Lote\n\n```python\nimport asyncio\nfrom mcp_fiscal_brasil import FiscalBrasil\n\nfiscal = FiscalBrasil()\n\ndocumentos = [\"529.982.247-25\", \"000.000.000-00\", \"11.222.333/0001-81\"]\n\nresultados = [\n {\"doc\": doc, \"válido\": fiscal.validate_cpf(doc) or fiscal.validate_cnpj(doc)}\n for doc in documentos\n]\n# [{'doc': '529.982.247-25', 'válido': True}, ...]\n```\n\n---\n\n## 🏗 Arquitetura\n\n```\nClaude / GPT / Cursor / qualquer cliente MCP\n |\n | Model Context Protocol (stdio)\n v\n mcp-fiscal-brasil\n |\n +------+-------+--------+--------+--------+-------+--------+\n | | | | | | | |\n CNPJ CPF NFe NFSe Simples SPED eSocial Certidões\n | | | | | | | |\n v v v v v v v v\nBrasilAPI -- SEFAZ Portais Receita Parser Catálogo URLs\nReceitaWS estaduais municipais Federal local local governamentais\n```\n\n**Fontes de dados:**\n- [BrasilAPI](https://brasilapi.com.br) - CNPJ, CEP, bancos (open source, sem autenticação)\n- [ReceitaWS](https://www.receitaws.com.br) - CNPJ (fallback)\n- SEFAZs estaduais - Status de serviço e consulta de NFe\n- Receita Federal - Simples Nacional e certidões (orientação de acesso)\n\n---\n\n## 📍 Roadmap\n\n- [x] **v0.1.x** - Consultas CNPJ, CPF, NFe, Simples Nacional e SPED; ~14 tools MCP\n- [x] **v0.2.x** - Infra production-grade (_core), CLI, REST API, Web UI demo, wrapper npm/Node.js e tools agênticas (compliance, due diligence, comparativo de regimes); ~20 tools MCP\n- [x] **v0.3.x** - Tabelas fiscais offline (NCM/TIPI, CFOP, CST, CEST, ICMS interestadual) e indexadores BCB (Selic, IPCA, PTAX, correção monetária); ~36 tools MCP\n- [x] **v0.4.x** - Módulo NF-e completo (parse, DANFE, assinatura XMLDSig, distribuição mTLS, manifestação do destinatário) e simulador da Reforma Tributária IBS/CBS (LC 214/2025); ~42 tools MCP\n- [x] **v0.5.x** - Módulo de importação (II, IPI, PIS/COFINS-importação, ICMS grossed-up, AFRMM, Siscomex) por NCM; circuit breaker NFS-e; correções SPED e path injection; automação de release; ~44 tools MCP\n- [ ] **v0.6.x** - NFC-e modelo 65 (DANFE cupom, autorizacao e cancelamento); NFS-e por provedor/municipio; validação XSD completa NF-e e SPED\n- [ ] **v0.7.x** - eSocial versionado (S-1.1); cache persistente entre sessões; LGPD audit trail\n- [ ] **v1.0.0** - Suíte fiscal com contratos de API estáveis, cobertura operacional ampliada e SLA de manutenção documentado\n\n---\n\n## Como acompanhar\n\n[](https://github.com/DeHor-Labs/mcp-fiscal-brasil/discussions)\n[](https://github.com/DeHor-Labs/mcp-fiscal-brasil/stargazers)\n\n\n\n Feito com 💚💛 para o Brasil\n
\n Conectando inteligência artificial ao sistema fiscal mais complexo do mundo\n