How to Use the PIS/COFINS Tax Calculator MCP in OpenAI Agents SDK

Stop wasting cash on Brazilian tax errors. Run precise PIS/COFINS calculations directly inside your OpenAI Agents SDK pipeline.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect PIS/COFINS Tax Calculator MCP to OpenAI Agents SDK

Create your Vinkius account to connect PIS/COFINS Tax Calculator 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 PIS/COFINS Tax Calculator with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Calculate cumulative liabilities via OpenAI Agents SDK

The `calculate_cumulative_tax` tool lets your agent compute PIS and COFINS liabilities under the cumulative regime using your gross revenue data. This is critical for service-heavy subsidiaries in Brazil where input credits do not apply. By feeding this MCP directly into your agentic pipeline, you prevent manual spreadsheet errors. Your agent can automatically check compliance against the standard 3.65 percent combined rate without human intervention.

Assess credits under the non-cumulative regime

The `calculate_non_cumulative_tax` tool processes your operational costs to determine your net tax liability. Let's be real, tracking deductible inputs in Brazil is a nightmare that usually leads to cash leakage. Your agent can now automate this process. It extracts invoice values, applies the 9.25 percent rate, subtracts eligible credits, and gives you a clear bottom-line figure.

Compare tax regimes using this MCP

The `evaluate_regime_comparison` tool analyzes your financial data to pinpoint the most profitable tax regime for your Brazilian entity. Run the numbers first. Choosing the wrong setup can cost your business millions in lost credits or high rates. This MCP provides the raw math your agent needs to make the right choice. Your agent can run this check quarterly to ensure your corporate structure remains optimized as your cost profile shifts.

Setup guide

Set up PIS/COFINS Tax Calculator 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 PIS/COFINS Tax Calculator tools at runtime.
3

Create your Agent

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

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate PIS/COFINS Tax Calculator 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="PIS/COFINS Tax Calculator Agent",
            instructions="You have access to PIS/COFINS Tax Calculator 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 PIS/COFINS 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.

Why Choose Vinkius

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

Connect PIS/COFINS Tax Calculator 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 PIS/COFINS Tax Calculator MCP in OpenAI Agents SDK

Install the openai-agents package and initialize the streamable HTTP transport pointing to our hosted URL. Pass the toolset directly to your agent constructor. The agent will auto-discover the tools and run them within your defined guardrails.

Yes. The agent uses the non-cumulative tool to subtract eligible input tax credits from your gross liability. This helps your agent identify exactly where your company is bleeding cash.

Yes. You can program your agent to run comparative audits quarterly. It compares historical revenue structures against both tax regimes to ensure you are not overpaying.

The tool returns a clear error payload detailing the missing or malformed fields. Your agent can catch this error, ask for clarification, or log the issue to your dashboard without crashing the pipeline.

Your Brazilian revenue data and tax invoices are processed in transit and never stored on our servers. We use enterprise-grade encryption to ensure your sensitive financial records remain completely private during execution.

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