# Simples Nacional Br

> Simples Nacional Br is an open-source MCP server for finance and payments. Calculate Brazilian Simples Nacional effective rate, monthly DAS and Fator R. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Web
- **Website:** https://peterwkdev-creator.github.io/simples-nacional-br/
- **Repository:** https://github.com/peterwkdev-creator/simples-nacional-br
- **MCP Registry name:** io.github.peterwkdev-creator/simples-nacional-br
- **Categories:** finance and payments, legal and government
- **Listing updated:** 2026-11-14

## About

Tax estimates here are checked bracket by bracket against Lei Complementar 123/2006 (as amended by LC 155/2016) and, from 2027, LC 214/2025. The library is pure Python on the standard library and uses `Decimal` throughout; floats are refused because they get cents wrong.

Given the last 12 months of revenue (RBT12) and the month's revenue, it returns the effective rate, the amount due for the month and each tax's share. It also covers companies with under 12 months of activity, computes how much payroll moves a business into Annex III under Fator R, and looks up the annex for a CNAE activity with the legal basis. RBT12 above R$ 4.8 million raises an error.

The README is explicit that this is an estimate, not tax advice, and does not replace PGDAS-D or an accountant. A browser page runs the same library through Pyodide so no numbers leave your machine. It installs from PyPI as `simples-nacional-br` and runs over stdio.

## Features

- **Effective rate:** Computes the effective rate from RBT12 using the statutory formula.
- **Monthly DAS:** Returns the amount due for the month with warnings.
- **Fator R:** Shows the payroll needed for Annex III and the change in DAS.
- **CNAE lookup:** Finds the annex for an activity with its legal basis.
- **New companies:** Handles businesses under 12 months from each month's revenue.
- **Exact decimals:** Uses Decimal and rejects floats to avoid cent errors.

## Good for

- Estimate this month's DAS for an Annex III company
- Test whether raising payroll lowers the tax under Fator R
- Look up which annex a CNAE falls under
- Build fiscal software that checks tax-table calculations

## Install

### Claude Code (Terminal)

```sh
claude mcp add simples-nacional-br -- uvx simples-nacional-br
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "simples-nacional-br": {
      "command": "uvx",
      "args": [
        "simples-nacional-br"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "simples-nacional-br": {
      "command": "uvx",
      "args": [
        "simples-nacional-br"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "simples-nacional-br": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "simples-nacional-br"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "simples-nacional-br": {
      "command": "uvx",
      "args": [
        "simples-nacional-br"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "simples-nacional-br": {
      "command": "uvx",
      "args": [
        "simples-nacional-br"
      ]
    }
  }
}
```

## FAQ

### Is this tax advice?

No. The README says it is an estimate that does not replace PGDAS-D or an accountant.

### Which law tables does it use?

LC 123/2006 as amended by LC 155/2016, and LC 214/2025 from 2027.

### Does my data leave my computer?

The browser demo runs the library locally with Pyodide, and the README says no number leaves your computer.

### What Python version is needed?

Python 3.9 or newer with no other dependencies.

### Is Simples Nacional Br free?

Yes. Simples Nacional Br is open source, so you can use and self-host it for free.

### How do I add Simples Nacional Br to Claude Code?

Run this command in your terminal: claude mcp add simples-nacional-br -- uvx simples-nacional-br

### What are the best alternatives to Simples Nacional Br?

The closest alternatives to Simples Nacional Br are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, NY LLC Publication (FileMyPublication) and Quantivex Research.

## 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.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [SupplyClub Catalog](https://ai-powered.com/mcp/supplyclub-catalog): SupplyClub Catalog is a free MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/simples-nacional-br
