Mcp Fiscal Brasil
by nikolasdehorcommunityv0.2.1
125
25
Servidor MCP e SDK Python para consultar dados fiscais brasileiros, incluindo CNPJ, CPF, NFe, Simples Nacional, SPED, eSocial, certidões e status de SEFAZ. Também oferece ferramentas offline de validação e consultas que retornam URLs/instruções para portais governamentais.
From the registry: Servidor MCP para integrar IAs com o sistema fiscal brasileiro: CNPJ, NFe, NFSe, SPED, eSocial.
Install & configure
Prerequisites
- requiredInstall Python 3.10 or newerPython 3.10+ is required to install and run the server.https://www.python.org/downloads/
- requiredInstall the packageInstall the MCP server from PyPI using pip. This is the simplest portable install path described in the README.
https://pypi.org/project/mcp-fiscal-brasil/$ pip install mcp-fiscal-brasil
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `mcp-fiscal-brasil` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Python 3.10 or newer** — Python 3.10+ is required to install and run the server. (https://www.python.org/downloads/)
- **Install the package** — Install the MCP server from PyPI using pip. This is the simplest portable install path described in the README. Run: `pip install mcp-fiscal-brasil` (https://pypi.org/project/mcp-fiscal-brasil/)
Canonical MCP server config (stdio transport):
- command: `mcp-fiscal-brasil`
- args: []
- optional environment variables:
- `MCP_FISCAL_LOG_LEVEL`: Log level for the server. Accepted values include DEBUG, INFO, and WARNING. (example: `<DEBUG|INFO|WARNING>`)
- `BRASILAPI_BASE_URL`: Base URL for BrasilAPI, for custom environments. (example: `<your-brasilapi-base-url>`)
- `HTTP_TIMEOUT`: HTTP timeout in seconds for outbound requests. (example: `<timeout-in-seconds>`)
Note: The README states the server works without any environment variables. It also shows an optional Docker run example, but the canonical MCP configuration uses stdio with the command `mcp-fiscal-brasil`.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: The README states the server works without any environment variables. It also shows an optional Docker run example, but the canonical MCP configuration uses stdio with the command `mcp-fiscal-brasil`.
Tools (14)
consultar_cnpj
Obtém dados completos de um CNPJ, como razão social, sócios, CNAE e endereço.
consultar_simples_nacional
Consulta se um CNPJ é optante do Simples Nacional ou MEI, com datas de entrada e exclusão.
validar_chave_nfe
Valida uma chave de NFe e extrai UF, CNPJ, data, número e dígito verificador.
consultar_status_sefaz
Consulta o status do webservice SEFAZ por estado.
consultar_nfe
Consulta uma NFe completa pela chave de 44 dígitos.
validar_cpf
Valida o dígito verificador de um CPF.
analisar_sped
Analisa arquivos EFD, ECD ou ECF para identificar período, empresa e erros.
listar_registros_sped
Filtra e lista registros de SPED por tipo, como C100 ou E110.
listar_eventos_esocial
Lista eventos de eSocial filtráveis por grupo.
validar_evento_esocial
Faz validação básica da estrutura XML de um evento de eSocial.
consultar_nfse
Retorna a URL do portal NFSe do município e o sistema utilizado.
consultar_certidao_federal
Retorna a URL do e-CAC para emissão de CND federal.
Prerequisites
- • Python 3.10+
Packages
mcp-fiscal-brasil
pypiv0.2.1transport: stdio
Details
- Language
- Python
- License
- MIT
- Released
- May 29, 2026
- Last commit
- Jul 12, 2026
- Registry name
- io.github.nikolasdehor/mcp-fiscal-brasil