Vinkius
ICMS Calculator

ICMS Calculator MCP for AI. Calculate complex Brazilian tax liabilities accurately.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

ICMS Calculator MCP on Cursor AI Code EditorICMS Calculator MCP on Claude Desktop AppICMS Calculator MCP on OpenAI Agents SDKICMS Calculator MCP on Visual Studio CodeICMS Calculator MCP on GitHub Copilot AI AgentICMS Calculator MCP on Google Gemini AIICMS Calculator MCP on Lovable AI DevelopmentICMS Calculator MCP on Mistral AI AgentsICMS Calculator MCP on Amazon AWS Bedrock

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.

+ 1 more capabilities included
Determine Applicable Rates

Identify the correct tax rate by inputting the starting and ending regions of the shipment.

Calculate Tax Base Value

Compute the grossed-up product value required for 'inside' calculation methods.

Determine Tax Substitution (ST)

Calculate the precise amount of ICMS-ST that must be collected during a transaction.

Compute Tax Differential (DIFAL)

Figure out the required tax differential for any B2C interstate operation.

Included with Plan

Waiting for input…

AI Agent

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 Vinkius

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...

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.

Claude AI

Claude AI

1

Open Claude Settings

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

2

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.

3

Start a conversation

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

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 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
ICMS 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 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

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.

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.

Built · Hosted · Managed by Vinkius ICMS Calculator - Brazilian Tax Compliance Tool
Server ID 019ed0fa-85f0-73e9-b14f-ab5084b6ff90
Vinkius Inspector
Compliance Grade A+
Score 100/100
Vinkius Inspector Badge — Score 100/100

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.

Built & Managed by Vinkius 30s setup 4 tools

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 runs on Claude Claude
Vinkius runs on ChatGPT ChatGPT
Vinkius runs on Cursor Cursor
Vinkius runs on Gemini Gemini
Vinkius runs on Windsurf Windsurf
Vinkius runs on VS Code VS Code
Vinkius runs on JetBrains JetBrains
Vinkius runs on Vercel Vercel
+ other MCP clients

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.

Zero hosting required Full MCP catalog included Enterprise-grade security Auto-updated by Vinkius

Built, hosted, and secured by Vinkius. You just connect and go.