How to Use the Tax Regime Comparator MCP in OpenAI Agents SDK

Stop guessing your tax burden. Use the Tax Regime Comparator with OpenAI Agents SDK to model your Brazilian fiscal strategy.

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 OpenAI Agents SDK

Create your Vinkius account to connect Tax Regime Comparator to OpenAI Agents SDK — 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 OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Run fiscal simulations for your agent

Your agent uses `compare_tax_regimes` to evaluate different Brazilian tax structures against your actual revenue data. It runs the numbers so you don't have to. This MCP gives your production pipeline the data it needs to choose between Simples Nacional, Lucro Presumido, and Lucro Real. It turns raw accounting inputs into a clear, actionable decision.

Validate tax components in real-time

The `get_regime_breakdown` tool pulls specific IRPJ, CSLL, PIS, and COFINS figures for any regime you select. It breaks down the liability so you can see exactly where the money goes. Your agent checks these values against your guardrails before finalizing any fiscal reporting. You get a clean, validated data stream that fits directly into your existing dashboard.

Secure fiscal data processing

This MCP handles sensitive financial calculations locally within your agent context. You keep full control over your tax data without exposing it to third-party black boxes. Integrate this with your tracing setup to log every fiscal decision. You'll know exactly which variables triggered a specific tax recommendation.

Setup guide

Set up Tax Regime Comparator MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Tax Regime Comparator tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Tax Regime Comparator tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Tax Regime Comparator tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Tax Regime Comparator Agent",
            instructions="You have access to Tax Regime Comparator tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 OpenAI Agents SDK

You connect the MCP by passing it directly to the agent constructor. Initialize the connection using the standard HTTP parameters and the agent will auto-discover the tools.

Yes, the tools handle the non-cumulative credit dynamics required for Lucro Real. The results provide the granular data needed to justify your fiscal choices.

No, the tools operate on the data you provide during the conversation. You feed the revenue and expense figures to the agent, and it handles the math.

The logic is built on current 2024 tax brackets. You should verify results against any new legislation as it passes.

Your financial inputs stay within your local agent session. This MCP only processes the numbers you share with it to generate your tax breakdown.

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