Simples Nacional Br
Calculate Brazilian Simples Nacional effective rate, monthly DAS and Fator R
- 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-brAdd to claude_desktop_config.json
{
"mcpServers": {
"simples-nacional-br": {
"command": "uvx",
"args": [
"simples-nacional-br"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"simples-nacional-br": {
"command": "uvx",
"args": [
"simples-nacional-br"
]
}
}
}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

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

NY LLC Publication (FileMyPublication)
MCP serverNew York LLC publication rules, deadline, county prices, clerks and notice text
- 8 tools
- Remote
- Free
- Legal and government

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments