# MCP Fiscal Brasil

> MCP Fiscal Brasil is an open-source MCP server for finance and payments. Brazilian tax tools: CNPJ, NF-e, IBS/CBS, ICMS, Simples Nacional, NCM and CFOP, no API key. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Repository:** https://github.com/dehor-labs/mcp-fiscal-brasil
- **MCP Registry name:** io.github.DeHor-Labs/mcp-fiscal-brasil
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [legal and government](https://ai-powered.com/categories/legal-and-government)
- **Listing updated:** 2026-11-18

## About

The package concentrates on fiscal work rather than general public data. It parses and validates NF-e XML, checks a 44-digit key offline, analyzes SPED and eSocial files offline, and bundles reference tables for NCM, CFOP and CNAE. It also covers the 2026 tax reform (IBS and CBS), Simples Nacional and MEI status, and optional A1 certificate access to SEFAZ.

Six higher-level tools turn lookups into decisions: analyze_cnpj_compliance, risk_score_supplier (a 0 to 100 supplier score with a recommendation), consultar_empresas_lote for batch CNPJ screening, compare_tax_regimes across MEI, Simples, presumed profit and real profit, validate_nfe_full and summarize_sped. Lookups use BrasilAPI and other free sources; a premium cpfcnpj.com.br source is opt-in.

Besides MCP over stdio it ships a CLI, a REST API with a demo web interface and a Node.js wrapper in preview. The documentation is in Portuguese.

## Features

- **Supplier risk score:** Scores a supplier 0 to 100 with a recommendation.
- **NF-e validation:** Parses XML, checks keys and returns structured issues.
- **Offline SPED and eSocial:** Summarizes files without sending them anywhere.
- **Tax regime comparison:** Compares MEI, Simples, presumed and real profit.
- **Reference tables:** Offline NCM, CFOP and CNAE tables.
- **Batch CNPJ screening:** Several companies per call with compliance and score.

## Good for

- Screen a list of suppliers by CNPJ
- Validate an NF-e XML before filing
- Compare tax regimes for a company's revenue and payroll
- Summarize a SPED file for a review

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-fiscal-brasil -- uvx mcp-fiscal-brasil
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-fiscal-brasil": {
      "command": "uvx",
      "args": [
        "mcp-fiscal-brasil"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-fiscal-brasil": {
      "command": "uvx",
      "args": [
        "mcp-fiscal-brasil"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-fiscal-brasil": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-fiscal-brasil"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-fiscal-brasil": {
      "command": "uvx",
      "args": [
        "mcp-fiscal-brasil"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-fiscal-brasil": {
      "command": "uvx",
      "args": [
        "mcp-fiscal-brasil"
      ]
    }
  }
}
```

## Tools

- `analyze_cnpj_compliance`: Consolidated compliance report for a CNPJ.
- `risk_score_supplier`: Supplier risk score with a recommendation.
- `consultar_empresas_lote`: Batch CNPJ screening.
- `compare_tax_regimes`: Compares tax regimes by scenario.
- `validate_nfe_full`: Validates a full NF-e from XML.
- `summarize_sped`: Executive summary of a SPED file.
- `consultar_cnpj`: Full company data for a CNPJ.
- `consultar_simples_nacional`: Simples and MEI status.
- `validar_chave_nfe`: Validates an NF-e key offline.
- `consultar_nfe`: Looks up an NF-e by key.

## FAQ

### Do I need an API key?

No. It works without an account or key; a premium CNPJ source is opt-in.

### How do I run it?

Run uvx mcp-fiscal-brasil or add it to a client config.

### Does it cover the 2026 tax reform?

Yes, IBS and CBS are covered.

### Are there other interfaces?

A CLI, a REST API with demo web interface and a Node.js wrapper in preview.

### Is MCP Fiscal Brasil free?

Yes. MCP Fiscal Brasil is open source, so you can use and self-host it for free.

### How do I add MCP Fiscal Brasil to Claude Code?

Run this command in your terminal: claude mcp add mcp-fiscal-brasil -- uvx mcp-fiscal-brasil

### What are the best alternatives to MCP Fiscal Brasil?

The closest alternatives to MCP Fiscal Brasil are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Data Ny and Crypto Feeds.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Data Ny](https://ai-powered.com/mcp/data-ny): Data Ny is a freemium MCP server for legal and government.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [Datos Gob Es](https://ai-powered.com/mcp/datos-gob-es): Datos Gob Es is a freemium MCP server for legal and government.
- [Datos Cl](https://ai-powered.com/mcp/datos-cl): Datos Cl is a freemium MCP server for legal and government.
- [Cipo](https://ai-powered.com/mcp/cipo): Cipo is a freemium MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/mcp-fiscal-brasil
