Skip to content
MCP server

MCP Fiscal Brasil

Brazilian tax tools: CNPJ, NF-e, IBS/CBS, ICMS, Simples Nacional, NCM and CFOP, no API key

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API
Runs
Locally
Version
0.5.1
Listing updated
today

Similar MCP servers

About MCP Fiscal Brasil

MCP Fiscal Brasil is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add mcp-fiscal-brasil -- uvx mcp-fiscal-brasil

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-fiscal-brasil": {
      "command": "uvx",
      "args": [
        "mcp-fiscal-brasil"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-fiscal-brasil": {
      "command": "uvx",
      "args": [
        "mcp-fiscal-brasil"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Free, no key; premium CNPJ data source optional

MCP Fiscal Brasil 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.

How AIPoweredBot checks servers