Reported issues for MCP Fiscal Brasil

Pod holds 6 of 6 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to MCP Fiscal Brasil.

Most discussed

consultar_status_sefaz retorna erro genérico sem detalhes de diagnóstico (status code, exceção, etc.)

Descrição

Ao chamar consultar_status_sefaz("SP"), a função retorna uma falha genérica sem nenhuma informação que permita diagnosticar a causa raiz (timeout, erro de rede, certificado, DNS, ou o próprio SEFAZ fora do ar).

Reprodução

import asyncio
import mcp_fiscal_brasil.nfe as nfe

async def main():
    result = await nfe.consultar_status_sefaz("SP")
    print(result)

asyncio.run(main())

Saída obtida

sucesso=True consultado_em=... uf='SP' status='Indisponível'

[Read the thread](https://github.com/DeHor-Labs/mcp-fiscal-brasil/issues/136) · 2026-08-28 · open · external user · 1 comment

### consultar_status_sefaz retorna erro genérico sem detalhes de diagnóstico (status code, exceção, etc.)

## Descrição

Ao chamar `consultar_status_sefaz("SP")`, a função retorna uma falha genérica sem
nenhuma informação que permita diagnosticar a causa raiz (timeout, erro de rede,
certificado, DNS, ou o próprio SEFAZ fora do ar).

## Reprodução

```python
import asyncio
import mcp_fiscal_brasil.nfe as nfe

async def main():
    result = await nfe.consultar_status_sefaz("SP")
    print(result)

asyncio.run(main())

Saída obtida

sucesso=True consultado_em=... uf='SP' status='Indisponível'

[Read the thread](https://github.com/DeHor-Labs/mcp-fiscal-brasil/issues/136) · 2026-08-28 · open · external user · 1 comment

### Endpoint /v1/simples/{cnpj} retorna 500 quando CNPJ não é optante do Simples Nacional

## Description

O endpoint REST `GET /v1/simples/{cnpj}` retorna `500 Internal Server Error` para qualquer CNPJ válido que não seja optante do Simples Nacional, em vez de uma resposta estruturada (ex.: `optante: false` ou 404 com mensagem clara).

Causa raiz: a BrasilAPI responde `404` para CNPJs sem registro no Simples. O client (`simples/client.py`) converte isso corretamente em `FiscalNotFoundError`, mas o handler REST em `api.py` (`simples_lookup`, linha ~168-173) não captura essa exceção — 

[Read the thread](https://github.com/DeHor-Labs/mcp-fiscal-brasil/issues/135) · 2026-08-27 · open · external user · 1 comment

### Endpoint /v1/simples/{cnpj} retorna 500 quando CNPJ não é optante do Simples Nacional

## Description

O endpoint REST `GET /v1/simples/{cnpj}` retorna `500 Internal Server Error` para qualquer CNPJ válido que não seja optante do Simples Nacional, em vez de uma resposta estruturada (ex.: `optante: false` ou 404 com mensagem clara).

Causa raiz: a BrasilAPI responde `404` para CNPJs sem registro no Simples. O client (`simples/client.py`) converte isso corretamente em `FiscalNotFoundError`, mas o handler REST em `api.py` (`simples_lookup`, linha ~168-173) não captura essa exceção — 

[Read the thread](https://github.com/DeHor-Labs/mcp-fiscal-brasil/issues/135) · 2026-08-27 · open · external user · 1 comment

### [BUG] Parser SPED não extrai valores numéricos — PIS/COFINS/ICMS retornam zerados

## Descrição

O MCP Fiscal Brasil v0.3.1 não extrai valores numéricos dos registros SPED. As ferramentas `listar_registros_sped` e `summarize_sped` retornam apenas contagem de registros e strings brutas, sem conversão numérica nem soma de totais.

## Bugs encontrados

### 1. `listar_registros_sped` retorna campos como string bruta
**Arquivo:** `sped/tools.py`, função `listar_registros_sped()`

Retorna:
```json
{"registro": "M210", "campos": "51|3708500,27|3492919,42|...", "raw": "..."}

Deve

Read the thread · 2026-06-20 · closed · external user · 2 comments

[BUG] Parser SPED não extrai valores numéricos — PIS/COFINS/ICMS retornam zerados

Descrição

O MCP Fiscal Brasil v0.3.1 não extrai valores numéricos dos registros SPED. As ferramentas listar_registros_sped e summarize_sped retornam apenas contagem de registros e strings brutas, sem conversão numérica nem soma de totais.

Bugs encontrados

1. listar_registros_sped retorna campos como string bruta

Arquivo: sped/tools.py, função listar_registros_sped()

Retorna:

{"registro": "M210", "campos": "51|3708500,27|3492919,42|...", "raw": "..."}

Deve

Read the thread · 2026-06-20 · closed · external user · 2 comments

Most recent

The remaining reports are on the project's issue tracker.