MCP Fiscal Brasil
Brazilian tax tools: CNPJ, NF-e, IBS/CBS, ICMS, Simples Nacional, NCM and CFOP, no API key
- 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-brasilAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-fiscal-brasil": {
"command": "uvx",
"args": [
"mcp-fiscal-brasil"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-fiscal-brasil": {
"command": "uvx",
"args": [
"mcp-fiscal-brasil"
]
}
}
}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.

