How to Use the Tax Regime Comparator MCP in Claude

Stop guessing your Brazilian tax burden. Run simulations directly in Claude Desktop to find the exact regime that saves your business cash.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Tax Regime Comparator MCP to Claude Desktop

Create your Vinkius account to connect Tax Regime Comparator to Claude Desktop — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Tax Regime Comparator with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Run regime simulations inside Claude Desktop

The `compare_tax_regimes` tool does the heavy lifting for your annual tax election. You feed it your projected revenue and payroll numbers, and it spits out the exact tax burden for Simples Nacional, Lucro Presumido, and Lucro Real. This MCP Server keeps you out of spreadsheets. You ask your AI client to run the numbers, and it returns the most efficient structure based on your actual cash flow constraints.

Audit your tax components line by line

The `get_regime_breakdown` tool gives you the granular details when you need to defend your numbers to the Receita Federal. It breaks down PIS, COFINS, IRPJ, and CSLL for whichever regime you are evaluating. You get a clear view of where every real goes. This stops you from flying blind when your accountant asks why you chose a specific bracket.

Connect local financial data to your MCP

Claude Desktop connects to your local files. You can pull CSV exports from your ERP directly into the chat without uploading them to a third-party cloud. Your agent reads the raw data and runs the comparison locally. This keeps your sensitive financial records on your own machine while you figure out the best tax strategy.

Setup guide

Set up Tax Regime Comparator MCP in Claude Web or Desktop

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 Tax Regime Comparator MCP tools are available immediately — no restart needed.

Endpoint URL

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

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Tax Regime Comparator MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under tax-regime-comparator-mcp.

json

{
  "mcpServers": {
    "tax-regime-comparator-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Tax Regime Comparator. 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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Tax Regime Comparator now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Tax Regime Comparator MCP in Claude Desktop

You install the MCP via the desktop config file. Your AI client then calls the comparison tools directly from your local environment to evaluate your tax options.

Yes. Once you add the configuration to your settings, you just type your revenue and payroll figures into the chat. The agent handles the rest.

The MCP itself does not store your data. Because Claude Desktop runs tools locally via stdio transport, your financial inputs stay on your machine during the simulation.

The comparison tool flags the threshold breach. It will show you the exact tax penalty and force you to evaluate Lucro Presumido to avoid retroactive expulsion.

It processes gross revenue, total payroll costs, and monthly expense receipts. You feed these exact figures into the simulation to calculate the effective tax rate for each regime.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript