ICMS Calculator Connector for AI agents.
4 live capabilities
Calculate Brazilian ICMS, DIFAL, and tax substitution values for interstate trade.
Waiting for input…
Why people use ICMS Calculator
ICMS Calculator for Brazilian Tax Compliance
With this Connector, you just tell your AI client the product price and the destination state. The capability pulls the correct rate and handles the grossing-up logic in seconds. You get the final tax amount without the manual copy-pasting.
What Vinkius changes
You get accurate Brazilian tax math without ever opening a spreadsheet.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Calculating B2C DIFAL for a new shipment
An e-commerce owner asks their agent to find the DIFAL for a product moving from the Southeast to the North region.
- Real-world use case 02
Grossing up a product price for a state sale
A logistics manager needs to know the tax-inclusive base for a specific price.
- Real-world use case 03
Verifying ICMS-ST for a wholesale order
A tax accountant needs to check the substitution tax for a large shipment.
Complete set · 4capabilities
The complete ICMS Calculator capability set.
These are the exact actions your AI can choose when you ask it to work with ICMS Calculator.
01—04
4 capabilities in this set.
Part of 4 available through ICMS Calculator.
- 01 Capability
Calculate tax differential
Get the DIFAL amount for B2C interstate operations. It handles the math for different regional rates.
- 02 Capability
Calculate icms substitution
Calculate the amount of ICMS-ST to be collected. This capability uses the MVA margin to find the correct value.
- 03 Capability
Calculate tax base
Calculate the grossed-up product value using the "inside" method. It helps you find the correct tax-inclusive base.
- 04 Capability
Get interstate rate
Identify the correct interstate tax rate based on origin and destination. It pulls the right data for regional movements.
Set up in minutes
One URL. Then ask ICMS Calculator to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use ICMS Calculator from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_nKPLhJb00sxxzp6Bnq3okHk7UsNFivgJGnUkodcp/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it ICMS Calculator, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable ICMS Calculator for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_nKPLhJb00sxxzp6Bnq3okHk7UsNFivgJGnUkodcp/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the ICMS Calculator URL.
- Step 03
Save and start
Save the connection and enable ICMS Calculator in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"icms-calculator": {
"url": "https://edge.vinkius.com/vk_preview_nKPLhJb00sxxzp6Bnq3okHk7UsNFivgJGnUkodcp/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using ICMS Calculator
Open Agent mode in chat and ask: "Using ICMS Calculator, help me...". 4 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"icms-calculator": {
"url": "https://edge.vinkius.com/vk_preview_nKPLhJb00sxxzp6Bnq3okHk7UsNFivgJGnUkodcp/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using ICMS Calculator
Ask Copilot: "Using ICMS Calculator, help me...". 4 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"icms-calculator": {
"url": "https://edge.vinkius.com/vk_preview_nKPLhJb00sxxzp6Bnq3okHk7UsNFivgJGnUkodcp/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using ICMS Calculator
Open Cascade and ask: "Using ICMS Calculator, help me...". 4 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"icms-calculator": {
"url": "https://edge.vinkius.com/vk_preview_nKPLhJb00sxxzp6Bnq3okHk7UsNFivgJGnUkodcp/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using ICMS Calculator
Ask Cline: "Using ICMS Calculator, help me...". 4 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add icms-calculator --transport http "https://edge.vinkius.com/vk_preview_nKPLhJb00sxxzp6Bnq3okHk7UsNFivgJGnUkodcp/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using ICMS Calculator
Ask Claude: "Using ICMS Calculator, show me...". 4 tools are ready
Where the request belongs
Work ICMS Calculator can move forward.
This is for logistics managers and e-commerce owners who deal with multi-state Brazilian shipping and need to avoid manual tax calculation errors.
Logistics Coordinator
Checking interstate rates for a fleet of shipments across different Brazilian regions.
E-commerce Operations Manager
Calculating the correct ICMS-ST and DIFAL for a daily batch of B2C orders.
Tax Accountant
Verifying grossed-up product values and tax-inclusive bases for complex invoices.
Import/Export Manager
Determining regional tax rates for moving goods between specific state borders.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse Connectors
PIS/COFINS Tax Calculator
Calculate PIS and COFINS tax liabilities for cumulative and non-cumulative regimes.
Simples Nacional Calculator
Calculate effective tax rates, Fator R eligibility, and monthly DAS amounts for the Brazilian Simples Nacional regime.
Brazilian Income Tax & Social Security Calculator
Calculate Brazilian IRPF and INSS deductions for 2024/2025.
NFe.io
Orchestrate NFe.io services. manage service invoices (NFS-e), validate city codes, and monitor company data directly from any AI agent.
Brazil CLT Payroll Calculator
Calculate Brazil's CLT payroll components including INSS, IRRF, net pay, and employer costs.
Tax Regime Comparator
Simulate and compare Brazilian tax regimes to find the most cost-effective structure for your business.
Bring your own AI
Change the model, client or framework. Keep ICMS Calculator connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about ICMS Calculator.
The practical details behind the request, access and result.
Can the ICMS Calculator handle Brazilian tax substitution?
Yes, it calculates ICMS-ST amounts by factoring in the MVA margin for you.
Does the ICMS Calculator work for interstate B2C sales?
Yes, it includes a specific capability to calculate the DIFAL amount for B2C interstate operations.
How does the ICMS Calculator find state rates?
It identifies the correct interstate tax rate based on the specific origin and destination regions you provide.
Can I use the ICMS Calculator to gross up product values?
Yes, it can calculate the grossed-up product value using the "inside" calculation method.
Is the ICMS Calculator for Brazilian e-commerce?
It is a perfect fit for Brazilian e-commerce, especially for businesses shipping across state lines.
Does the ICMS Calculator handle different regional rates?
Yes, it pulls the correct rates automatically based on the regional movements of your goods.
How do I calculate the grossed-up product value?
Use the calculate_tax_base capability. 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 capability 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 capability determine the interstate rate?
The get_interstate_rate capability 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.
One connection away
Give your agent a direct line to ICMS Calculator.
Connect ICMS Calculator once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available