ICMS Calculator MCP for AI. Calculate complex Brazilian tax liabilities accurately.
Works with every AI agent you already use
…and any MCP-compatible client








Connect to your AI in seconds.
ICMS Calculator provides specialized tools to calculate complex Brazilian ICMS taxes. It handles Tax Substitution (ST), tax differentials (DIFAL) for B2C sales, and determines grossed-up product bases using the 'inside' calculation method.
Use it to retrieve correct interstate rates based on origin and destination regions for flawless financial reporting.
What your AI can do
Calculate tax differential
Figures out the DIFAL amount needed specifically for B2C interstate transactions.
Calculate icms substitution
Calculates the amount of ICMS-ST (Tax Substitution) that must be collected on a product.
Calculate tax base
Computes the grossed-up product value using the 'inside' calculation method for tax bases.
Identify the correct tax rate by inputting the starting and ending regions of the shipment.
Compute the grossed-up product value required for 'inside' calculation methods.
Calculate the precise amount of ICMS-ST that must be collected during a transaction.
Figure out the required tax differential for any B2C interstate operation.
Ask an AI about this
Waiting for input…
ICMS Calculator with 4 Tools
Use these four specialized tools to handle every facet of Brazilian ICMS tax calculation, from rate lookup to final differential 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 ICMS Calculator on VinkiusCalculate Tax Differential
Figures out the DIFAL amount needed specifically for B2C interstate transactions.
Calculate Icms Substitution
Calculates the amount of ICMS-ST (Tax Substitution) that must be collected on a...
Calculate Tax Base
Computes the grossed-up product value using the 'inside' calculation method for tax...
Get Interstate Rate
Retrieves the current, applicable tax rate between any specified Brazilian origin...
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.
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
Make Your AI Do More
Start with ICMS 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
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by ICMS 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
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.
The headache of manually calculating tax liabilities
Today, determining the correct ICMS liability means diving into dense regulatory documents. You're cross-referencing origin codes against destination codes, building complex formulas in spreadsheets, and constantly verifying which specific rate applies to a given product category—all before you even start the calculation.
With this MCP, you skip the manual research entirely. Input your transaction details once, and the system immediately calculates the required rates and tax components needed for compliant filing.
ICMS Calculator: Precision in Tax Substitution
The biggest time sink is building out separate modules just to look up rate variations or calculate specific differentials. You spend hours ensuring that your tax base calculations are correct before you even get to the final filing number.
Now, all those manual checks disappear. The MCP handles rate retrieval and complex formula execution in one go. Your output is always mathematically balanced.
What your AI can actually do with this
Calculating Brazilian ICMS taxes is a massive headache because the rules change constantly, depending entirely on where the goods start and where they end up. This MCP handles that complexity. You feed in your transaction details, and it figures out exactly what's owed—whether you need to calculate Tax Substitution (ST), figure out the tax differential for interstate B2C sales, or determine the correct grossed-up product value.
It also looks up applicable rates between regions. When you use this MCP through Vinkius, your agent gets a single source of truth for compliance calculations, eliminating guesswork from cross-state commerce.
019ed0fa-85f0-73e9-b14f-ab5084b6ff90 Here's how it actually works
The bottom line is that it structures a multi-layered calculation process into one simple workflow.
First, define your transaction details and specify both the origin and destination regions.
Next, use these inputs to calculate the necessary rates or specific tax components (ST, DIFAL) based on current law.
Finally, you receive the exact calculated figure needed for compliant filing and ledger posting.
Who is this actually for?
This MCP is critical for tax accountants, financial analysts, and operations managers who handle cross-state commerce within Brazil. If your job involves filing taxes or verifying pricing across multiple Brazilian regions, you need this.
Performs required calculations for ICMS tax substitution (ST) and ensures all state differentials are correctly computed for compliance.
Verifies the grossed-up product value using the 'inside' method, ensuring financial reporting matches statutory requirements.
Determines the correct interstate tax rates before shipping goods to avoid delays or fines at state borders.
What Changes When You Connect
Avoid costly miscalculations. Use calculate_tax_differential to get the exact DIFAL amount for B2C sales, preventing underreporting penalties.
Verify product values correctly. The calculate_tax_base tool determines the grossed-up value using the 'inside' method, which is essential for internal accounting records.
Ensure compliance across states. By calling get_interstate_rate, you retrieve the precise rate needed for any shipment between Brazilian regions.
Handle manufacturer filings easily. The calculate_icms_substitution tool computes ST amounts quickly, streamlining your tax documentation process.
Reduce manual effort by automating complex math. Instead of building multi-step formulas in a spreadsheet, this MCP executes the entire calculation chain instantly.
See it in action
Handling B2C interstate sales
A seller ships goods from São Paulo to Rio de Janeiro. They need to know the exact tax differential (DIFAL) owed. By using get_interstate_rate first, then running calculate_tax_differential, they generate a precise filing amount that matches state law.
Auditing product cost valuation
A corporate finance team needs to validate the listed price of a complex item. They run calculate_tax_base on the current sale data, confirming if the grossed-up value aligns with what auditors expect.
Filing manufacturer tax reports
A factory needs to file ST documentation for a new product line. They use calculate_icms_substitution along with the raw data inputs, generating the required substitution amount for their quarterly filings.
The honest tradeoffs
Using static tax rates
Copying a single percentage rate from an old manual and applying it to all transactions, regardless of state or region.
Always start by calling get_interstate_rate with the specific origin and destination regions. This ensures you get the current statutory rate before running any other calculation.
Ignoring tax-inclusive bases
Attempting to calculate a product's value using only the pre-tax price, leading to an undervalued tax base in the books.
Use calculate_tax_base immediately. This function correctly determines the grossed-up product value, giving you the accurate 'inside' basis for your records.
When It Fits, When It Doesn't
Use this MCP if your primary problem is mathematical precision in Brazilian tax law. Specifically, if you need to determine a final amount that depends on multiple variables—like origin/destination rates or whether it’s B2C or B2B—this tool handles the complexity for you. Don't use this if you just need general bookkeeping; that requires a standard accounting platform. You also shouldn't rely solely on the output without cross-referencing the governing statute, but if your math is complex and multi-jurisdictional, start here.
Questions you might have
How do I use calculate_tax_base for product valuation? +
You supply the nominal value and the tax rate to calculate_tax_base. It returns the required grossed-up product value using the 'inside' calculation method, which is critical for accurate inventory cost tracking.
What is DIFAL? How does calculate_tax_differential work? +
DIFAL (Tax Differential) is the tax owed in B2C interstate sales. Use calculate_tax_differential by supplying the transaction value and rate details, and it returns the exact differential amount needed for compliance.
I need to know the rates between my two states; should I use get_interstate_rate? +
Yes. get_interstate_rate is the tool you need. Just give it the origin and destination regions, and it pulls the current statutory tax rate for that specific movement.
What if I also need ST calculated? Do I use calculate_icms_substitution? +
That’s right. For Tax Substitution (ST), you must run calculate_icms_substitution. This function uses the MVA to determine the exact amount that needs to be collected for your filing.
What data inputs are mandatory for `calculate_tax_base`? +
The tool requires three key pieces of information: the net product value, the tax rate percentage, and whether you want the final calculation to reflect the grossed-up or exclusive price. Providing these details ensures an accurate 'inside' method calculation.
If I use `get_interstate_rate` but provide incorrect origin or destination regions, what happens? +
The system will return a specific validation error detailing which region codes are invalid. Always double-check your state abbreviations against the official Brazilian tax lists before running the rate check.
Does `calculate_tax_differential` only work for B2C interstate operations? +
Yes, this MCP tool is strictly designed to calculate DIFAL amounts for Business-to-Consumer transactions across state lines. It will not process tax differentials for internal or B2B sales.
How do I properly use the Added Value Margin (MVA) when running `calculate_icms_substitution`? +
The MCP needs you to provide the correct MVA percentage. This margin is critical because it determines how we calculate Tax Substitution; ensure the provided rate matches the product's classification.
How do I calculate the grossed-up product value? +
Use the calculate_tax_base tool. You provide the net product value and the tax rate, and it returns the grossed-up base and the tax amount included in that base.
Can I calculate ICMS-ST with MVA? +
Yes. The calculate_icms_substitution tool allows you to input the initial tax base, the MVA percentage, and the relevant interstate and internal rates to find the substitution amount.
How does the tool determine the interstate rate? +
The get_interstate_rate tool checks the origin and destination regions. It applies 4% for imports, 7% for movements from South/Southeast to North/Northeast/Midwest, and 12% for all other interstate routes.
We've already built the connector for ICMS Calculator. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 4 tools are live and waiting.
You're up and running in seconds.
Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.