Simples Nacional Calculator MCP for AI. Instantly calculate Brazilian tax rates and DAS payments.

Q: How can I find the tax rate for my business activity?

You can use the getbracketparameters tool. Provide your accumulated revenue from the last 12 months and the specific Annex type (e.g., Annex I for commerce) to retrieve the nominal rate and deduction amount.

Q: What is Fator R and how does it affect my taxes?

Fator R is a rule for certain service activities. By using evaluatefactorr, you can check if your payroll costs relative to revenue allow you to move from Annex V to the more favorable Annex III.

Q: Can I calculate the exact amount of DAS to pay?

Yes. After determining your effective rate, use computemonthlytaxamount with your current month's revenue to get the final currency value of your tax liability.

Q: What is the proper order of operations when using getbracketparameters and then calculateeffectiverate?

First, use getbracketparameters to confirm your applicable tax brackets. Then, feed those confirmed constants into calculateeffectiverate for a precise final calculation.

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

Connect to your AI in seconds.

Simples Nacional Calculator handles complex Brazilian tax calculations for small businesses. It automatically determines effective tax rates, checks eligibility for the Fator R reduction tier, and figures out your total monthly DAS amount based on specific revenue brackets across all five Annexes (I through V).

This MCP lets your agent accurately estimate required federal taxes without manual spreadsheet work.

What your AI can do

Calculate effective rate

Determines the precise, dynamic percentage rate that applies to the revenue.

Compute monthly tax amount

Calculates the total final tax amount (DAS) due for a given month's activity.

Evaluate factor r

Checks if the company qualifies for lower taxation tiers by analyzing payroll costs versus gross revenue.

+ 1 more capabilities included

Determine Effective Tax Rates

It calculates the actual percentage tax rate applied to revenue based on accumulated earnings and current deductions.

Check Fator R Eligibility

The MCP assesses if the company qualifies for reduced taxation tiers by comparing payroll spending to total gross revenue.

Calculate Final Tax Payments

It outputs a concrete, final tax amount (DAS) that must be paid for the reporting month.

Ask an AI about this

Included with Plan

Waiting for input…

AI Agent

Simples Nacional Calculator: 4 Tools

These tools allow you to calculate all aspects of the Brazilian Simples Nacional regime, from initial bracket parameters to final DAS amounts.

Make your AI actually useful.

Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.

Start using Simples Nacional Calculator on Vinkius

Calculate Effective Rate

Determines the precise, dynamic percentage rate that applies to the revenue.

Compute Monthly Tax Amount

Calculates the total final tax amount (DAS) due for a given month's activity.

Evaluate Factor R

Checks if the company qualifies for lower taxation tiers by analyzing payroll costs...

Get Bracket Parameters

Retrieves necessary tax constants and specific bracket thresholds based on the...

Security and governance baked right in.

Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.

Claude AI

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

Start a conversation

Open a new chat. The Simples Nacional Calculator integration is available immediately — no restart needed.

Antigravity

Configure Agent Environment

Open your Antigravity agent's workspace configuration or mcp-servers.json file.

Bind the Endpoint

Add the Vinkius endpoint URL to your agent's MCP connections list:

"mcp_servers": {
  "simples-nacional-calculator": {
    "serverUrl": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
  }
}

Provide your secure token in place of [YOUR_TOKEN_HERE] to ensure your agent requests are authenticated.

Execute

Start your Antigravity session. The agent will autonomously discover and utilize the Simples Nacional Calculator tools with full Vinkius guardrails applied.

VS Code Copilot

⚡

One-Click Install (Recommended)

In your Vinkius Dashboard, simply click the Add to VS Code button for this server. We'll automatically configure your local workspace.

Or configure manually

Open MCP Settings

Open VS Code, press Ctrl/Cmd + Shift + P, and search for GitHub Copilot: MCP Servers.

Add Server Config

Add the Vinkius endpoint configuration to your mcp-servers.json file:

"simples-nacional-calculator": {
  "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}

Ensure you replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.

LangChain

Install Dependencies

Install the LangChain MCP adapters for your environment:

pip install langchain-mcp-adapters

Connect the Server

Use the SSEClient in LangChain to connect to the Vinkius managed endpoint:

from langchain_mcp_adapters.client import SSEClient

# Connect to Vinkius
client = SSEClient(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
tools = client.get_tools()

CrewAI

Define the Tool

Load the Vinkius MCP tools into your CrewAI agents:

from crewai import Agent
from mcp_crewai import MCPTool

# Connect securely to Vinkius
vinkius_tools = MCPTool(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")

# Assign to Agent
researcher = Agent(
    role='Data Researcher',
    tools=vinkius_tools.get_all()
)

Execute Task

Run your CrewAI process. The agent will autonomously route tasks to the Vinkius managed server.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

Import from OpenAPI, Swagger, or YAML specs
Create Agent Skills with progressive disclosure
Deploy to edge with MCPFusion framework
Built in DLP, auth, and compliance on every call
Real time usage dashboard and cost metering
Publish to catalog or keep private

Start building

Make Your AI Do More

Start with Simples Nacional Calculator, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.

Use this MCP plus 5,100+ others, all in one place
Add new capabilities to your AI anytime you want
Every connection is secured and compliant automatically
Track usage and costs across all your servers
Works with Claude, ChatGPT, Cursor, and more
New servers added to the catalog every week

Simples Nacional Calculator MCP server cover

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Simples Nacional Calculator. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

VINKIUS INFRASTRUCTURE

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on every call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

Your data is protected. See how we built it.

Works with Claude, ChatGPT, Cursor, and more

The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.

This connection provides 4 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.

Manual Tax Calculations Are a Time Sink

Today, estimating a business's monthly tax payment means hopping between spreadsheets and government websites. You have to manually track accumulated revenue across five different annexes, cross-reference the current payroll rules against gross sales, and then build formulas that account for progressive deduction tiers. It’s tedious, error-prone work that eats up hours of your week.

With this MCP, you give the agent a few data points—the revenue and expenses—and it figures out the rest. It runs through the complex logic internally, giving you the precise final DAS amount in seconds. You get accurate tax numbers without touching a formula or an external website.

Calculate Tax Liability with Simples Nacional Calculator MCP

The biggest time savings come from eliminating the need to manually verify complex rules. You no longer have to calculate Fator R eligibility by hand, nor do you spend time looking up which tax constants apply based on your activity code.

You just get the answer. Your agent uses all the necessary tools—from `get_bracket_parameters` to `compute_monthly_tax_amount`—to deliver one clear figure. It’s instant compliance modeling.

Support 24/7 support@vinkius.com ↗

Security Vinkius Trust Center ↗

SLA Service Level Agreement ↗

Report Listing Send Report ↗

What your AI can actually do with this

Need to figure out a business's tax liability under Brazil’s Simples Nacional regime? This MCP provides the calculation engine for that. It takes raw financial data and calculates complex variables like effective rates and necessary deductions, which are usually handled by specialized local accounting software.

It handles progressive revenue tiers across multiple Annexes (I through V), so you don't have to worry about tracking accumulated revenue or fixed deduction thresholds yourself. You can run a check to see if the business qualifies for the Fator R reduction tier by comparing payroll expenses against gross sales, giving you an accurate estimate of the monthly tax payment (DAS) due.

When your agent runs these figures, it doesn't just spit out numbers; it provides structured data that tells you exactly which tax bracket applies and why. This level of precision is critical when dealing with compliance. Remember, while Vinkius hosts this MCP, we also enforce a financial circuit breaker with human-in-the-loop approval on every call that touches money.

Your AI sets the intent, but no transaction fires without your explicit sign-off.

Built · Hosted · Managed by Vinkius Simples Nacional Calculator - Brazil Tax Rate MCP

Server ID 019ed0fd-da18-7022-ba3a-5678e310930d

Vinkius Inspector

Compliance Grade A+

Score 100/100

Report View Report ↗

What Changes When You Connect

Stop relying on complex spreadsheets. The MCP handles the progressive revenue tiers across all Annexes, so you get a single, accurate rate calculation instead of dozens of manual checks.

Confirm Fator R eligibility instantly. Instead of manually comparing payroll records to gross sales, evaluate_factor_r tells you right away if the company qualifies for lower taxes.

Determine tax liability accurately. The system uses get_bracket_parameters first, ensuring that all calculations are based on the current official tax constants.

Get a final number without guessing. You don't just get rates; compute_monthly_tax_amount provides the definitive DAS figure required for filing.

Save hours of cross-referencing. By chaining these tools together, you move from data gathering to actionable compliance figures in minutes.

See it in action

01 01

A new client needs tax modeling

The analyst asks the agent: 'Calculate the effective rate and projected DAS for a 10,000 BRL revenue month with these payroll details.' The MCP uses get_bracket_parameters first, then runs calculate_effective_rate, finally using compute_monthly_tax_amount to deliver the final tax due.

02 02

Checking for rate reductions

A business owner needs to know if they qualify for a lower tax bracket. They simply prompt: 'Check my Fator R status.' The agent runs evaluate_factor_r and instantly returns the eligibility status, preventing them from overpaying or underreporting.

03 03

Comparing Annexes

An accountant needs to compare tax liability across different business activities. They prompt for calculations against various revenue figures in different annexes, letting the agent cycle through rates and calculate the final DAS using calculate_effective_rate.

04 04

Quick compliance check

During a meeting, you need to give an instant tax estimate. You prompt for the monthly payment given revenue and payroll data. The agent orchestrates all necessary steps to provide a single, reliable figure using compute_monthly_tax_amount.

The honest tradeoffs

Using general accounting tools

Anti-pattern

Relying on generic tax calculators that treat Brazil's complex Annex structures and Fator R rules as simple linear percentages.

The Fix

You must use this MCP. It specifically handles the nuances of Simples Nacional, running checks for evaluate_factor_r and using specialized constants from get_bracket_parameters to ensure compliance.

Manual spreadsheet calculation

Anti-pattern

Spending an afternoon building formulas that account for progressive brackets (RBT12) and then having the sheet break when a tax rule changes.

The Fix

Let your agent handle it. It runs calculate_effective_rate using the latest rules, so you get reliable numbers every time without formula maintenance.

Ignoring bracket constants

Anti-pattern

Calculating a rate based only on current revenue without first checking the official tax brackets and activity-specific parameters.

The Fix

Always start by calling get_bracket_parameters. This ensures your calculation is grounded in the correct, defined tax thresholds before you calculate anything.

When It Fits, When It Doesn't

Use this MCP if your primary need is calculating Brazilian Simples Nacional taxes. You must know that your numbers depend on specific Annexes and complex variables like Fator R. Don't use it if you only need basic payroll deductions or simple state sales tax calculations; a generic accounting tool might handle those simpler tasks fine. However, for anything involving the progressive federal rate structure of Simples Nacional, this MCP is essential because it contains tools that manage specific rulesets, such as evaluate_factor_r and the complex logic within calculate_effective_rate. If your problem involves Brazilian tax law, use this; otherwise, look elsewhere.

Questions you might have

How can I find the tax rate for my business activity? +

You can use the get_bracket_parameters tool. Provide your accumulated revenue from the last 12 months and the specific Annex type (e.g., Annex I for commerce) to retrieve the nominal rate and deduction amount.

What is Fator R and how does it affect my taxes? +

Fator R is a rule for certain service activities. By using evaluate_factor_r, you can check if your payroll costs relative to revenue allow you to move from Annex V to the more favorable Annex III.

Can I calculate the exact amount of DAS to pay? +

Yes. After determining your effective rate, use compute_monthly_tax_amount with your current month's revenue to get the final currency value of your tax liability.

How does `calculate_effective_rate` handle accumulated revenue from multiple months? +

It calculates the rate based on the Rolling 12-month Revenue (RBT12) average. You must provide the total accumulated gross revenue for the last twelve months and the specific annex code to ensure accuracy.

What inputs are needed when using `get_bracket_parameters`? +

You need three things: your CNAE (activity code), the current month's gross revenue, and the applicable tax Annex. Providing all three parameters ensures the correct taxation constants are retrieved.

If I run `compute_monthly_tax_amount` with conflicting data, what happens? +

The system will return a structured error message detailing which input fields conflict or are missing. This allows you to trace the exact point of failure in your tax data.

Can I use `evaluate_factor_r` if my payroll expenses were paid retroactively? +

Yes, as long as you provide accurate documentation for the actual expense dates. The tool accepts historical payroll expenditure data to determine current eligibility status.

What is the proper order of operations when using `get_bracket_parameters` and then `calculate_effective_rate`? +

First, use get_bracket_parameters to confirm your applicable tax brackets. Then, feed those confirmed constants into calculate_effective_rate for a precise final calculation.

Connect to your AI in seconds.

Calculate effective rate

Compute monthly tax amount

Evaluate factor r

Simples Nacional Calculator: 4 Tools

Make your AI actually useful.

Calculate Effective Rate

Compute Monthly Tax Amount

Evaluate Factor R

Get Bracket Parameters

Security and governance baked right in.

Claude AI

Open Claude Settings

Add Custom Connector

Start a conversation

Claude Code

Open your terminal

Add the MCP Server

Start coding

Cursor

One-Click Install (Recommended)

Open Cursor Settings

Add New Server

Use in Composer

Antigravity

Configure Agent Environment

Bind the Endpoint

Execute

VS Code Copilot

One-Click Install (Recommended)

Open MCP Settings

Add Server Config

Windsurf

One-Click Install (Recommended)

Open Windsurf Settings

Add Server Endpoint

LangChain

Install Dependencies

Connect the Server

CrewAI

Define the Tool

Execute Task

Choose How to Get Started

Build Your Own

Make Your AI Do More

Works with Claude, ChatGPT, Cursor, and more

Manual Tax Calculations Are a Time Sink

Calculate Tax Liability with Simples Nacional Calculator MCP

What your AI can actually do with this

Here's how it actually works

Who is this actually for?

What Changes When You Connect

See it in action

A new client needs tax modeling

Checking for rate reductions

Comparing Annexes

Quick compliance check

The honest tradeoffs

Using general accounting tools

Manual spreadsheet calculation

Ignoring bracket constants

When It Fits, When It Doesn't

Questions you might have