# 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](/mcp/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

```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

### 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](https://github.com/DeHor-Labs/mcp-fiscal-brasil/issues/61) · 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:
```json
{"registro": "M210", "campos": "51|3708500,27|3492919,42|...", "raw": "..."}
```

Deve

[Read the thread](https://github.com/DeHor-Labs/mcp-fiscal-brasil/issues/61) · 2026-06-20 · closed · external user · 2 comments

## Most recent

The remaining reports are on [the project's issue tracker](https://github.com/DeHor-Labs/mcp-fiscal-brasil/issues).