# MCP Fiscal Brasil

Gives your agent CNPJ checks, NF-e parsing, SPED summaries and Brazilian tax regime comparisons. No API key, no signup.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 335
- Author: DeHor-Labs
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/DeHor-Labs/mcp-fiscal-brasil
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-fiscal-brasil

## What it does

The server exposes Brazilian fiscal tools to your agent: NF-e XML parsing and validation, SPED summaries, CNPJ and CPF lookups, Simples Nacional and MEI regimes, NCM, CFOP and CNAE reference tables, plus IBS/CBS calculations for the 2026 tax reform. Some of it runs offline — XML parsing and the reference tables need no network.

Six high-level agent tools ship inside: `analyze_cnpj_compliance`, `risk_score_supplier`, `consultar_empresas_lote`, `compare_tax_regimes`, `validate_nfe_full`, `summarize_sped`. There are separate interfaces too — a `mcp-fiscal` CLI and a `mcp-fiscal-api` REST API with a demo web UI. The HTTP client handles retries, caching and per-host rate limits.

You need Python 3.11 or newer, since the server runs through `uvx`. Signing XML with an A1 certificate over mTLS to SEFAZ is opt-in and off by default. Behind a proxy or a private PyPI mirror, set that in your environment or the tool's config file rather than on the install line.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-fiscal-brasil -- uvx mcp-fiscal-brasil
```
uvx runs the command named after the package; if the README names another one, use uvx --from mcp-fiscal-brasil <command>

### Codex

**Platform CLI**
```bash
codex mcp add mcp-fiscal-brasil -- uvx mcp-fiscal-brasil
```
uvx runs the command named after the package; if the README names another one, use uvx --from mcp-fiscal-brasil <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-fiscal-brasil": {
            "command": "uvx",
            "args": [
                "mcp-fiscal-brasil"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from mcp-fiscal-brasil <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-fiscal-brasil": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "mcp-fiscal-brasil"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from mcp-fiscal-brasil <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mcp-fiscal-brasil uvx mcp-fiscal-brasil
```
uvx runs the command named after the package; if the README names another one, use uvx --from mcp-fiscal-brasil <command>

## When to use it
- vet a supplier by CNPJ before signing a contract
- parse an NF-e XML and catch key or issuer errors
- turn SPED blocks into a short report with inconsistencies
- compare MEI, Simples, Lucro Presumido and Lucro Real for a revenue figure
- screen a batch of CNPJs in one call with a risk score

## Example prompts
- check this supplier by CNPJ and give me a risk score
- parse this NF-e XML and list the issues
- compare tax regimes for 500000 revenue in the services sector

## Similar
- [pluggy-payments](https://affpapa.org/en/nevibecode/skills/pluggy-payments.md) — skill · 386 installs
- [popbill](https://affpapa.org/en/nevibecode/skills/popbill.md) — skill · 4400 installs
- [tax-prep](https://affpapa.org/en/nevibecode/skills/tax-prep.md) — skill · 1800 installs
- [crypto-tax-export](https://affpapa.org/en/nevibecode/skills/crypto-tax-export.md) — skill · 433 installs
- [depreciation-schedule](https://affpapa.org/en/nevibecode/skills/depreciation-schedule.md) — skill · 394 installs
- [app-marketplace-monetization-model](https://affpapa.org/en/nevibecode/skills/app-marketplace-monetization-model.md) — skill · 8100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md