Skip to content
MCP server

Simples Nacional Br

Calculate Brazilian Simples Nacional effective rate, monthly DAS and Fator R

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, API, Web
Runs
Locally
Version
1.7.1
Listing updated
3 days ago

About Simples Nacional Br

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

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

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

What it does

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

Pricing

Open source

Free open-source Python package

Prices change. Check peterwkdev-creator.github.io before you buy.

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 to Simples Nacional Br

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. New York LLC publication rules, deadline, county prices, clerks and notice text

    • 8 tools
    • Remote
    • Free
    • Legal and government
  5. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  6. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments