Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use ICMS Calculator with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Calculate Brazilian ICMS taxes, including tax substitution (ST), tax differentials (DIFAL), and tax-inclusive base calculations.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 4 capabilities

The complete ICMS Calculator capability set.

These are the exact actions your AI can choose when you ask it to work with ICMS Calculator.

Capability set01 / 01

01-04

4 capabilities in this set.

Part of 4 available through ICMS Calculator.

  1. 01

    Calculate tax differential

    Calculates the DIFAL amount for B2C interstate operations

  2. 02

    Get interstate rate

    Retrieves the correct interstate tax rate based on origin and destination regions

  3. 03

    Calculate tax base

    Calculates the grossed-up product value using the "inside" calculation method

  4. 04

    Calculate icms substitution

    Calculates the amount of ICMS-ST (Tax Substitution) to be collected

Observed, not estimated

648ms average. Fast in production.

ICMS Calculator is checked daily against the live service.

Daily averagePeak 765ms
Aug 20Today
Fastest day
516ms
Slowest day
765ms
14-day trend
Stable-2%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 4 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of ICMS Calculator, so you can see the experience inside your AI.

It does not authenticate your account with ICMS Calculator. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

ICMS Calculator Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_nKPLhJb00sxxzp6Bnq3okHk7UsNFivgJGnUkodcp/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — ICMS Calculator capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "icms-calculator-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_nKPLhJb00sxxzp6Bnq3okHk7UsNFivgJGnUkodcp/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions ICMS Calculator owners ask.

  • 01

    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.

  • 02

    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.

  • 03

    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.

Explore

More in Finance

Suggestions