ISS Calculator MCP. Determine tax liability for specific services.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
The ISS Calculator MCP handles Service Tax (ISS) compliance. It lets you determine tax rates based on a service type and specific municipality, check if withholding is mandatory, and compute the final tax liability including allowed deductions.
This tool ensures your billing calculations meet local financial regulations.
What your AI agents can do
Calculate tax liability
Computes the final tax amount owed after factoring in gross income, specific service details, and allowable deductions.
Check withholding status
Determines if local law mandates that the Service Tax must be withheld when making a payment.
Get applicable rate
Retrieves the precise tax rate percentage for a specified service type within any given municipality.
Finds the specific service tax percentage required for a given municipality and service type.
Verifies whether local law requires that the tax be withheld at the source of the transaction.
Calculates the final, compliant tax liability by accounting for gross amounts, deductions, and applicable rates.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
ISS Calculator with 3 Tools
These three tools allow you to perform a full compliance cycle: checking the required rate, validating withholding status, and computing the final service tax owed.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using ISS Calculator on Vinkius019ed0fbcalculate tax liability
Computes the final tax amount owed after factoring in gross income, specific service details, and allowable deductions.
019ed0fbcheck withholding status
Determines if local law mandates that the Service Tax must be withheld when making a payment.
019ed0fbget applicable rate
Retrieves the precise tax rate percentage for a specified service type within any given municipality.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with ISS Calculator, then connect any of our 4,900+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,900+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by ISS 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.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 3 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Tax compliance requires juggling multiple variables.
Right now, determining tax liability means cross-referencing municipal websites. You open one tab to find the rate by service type and another spreadsheet to check if withholding is required. Then you have to manually calculate the final taxable base, remembering which deductions apply only in certain regions. It's a mess of tabs, copies, and conditional formatting.
With this MCP, that process gets cut down to three steps. You ask your agent to confirm local tax status, then retrieve the exact rate for any location, and finally, run `calculate_tax_liability`. The result is one clean, compliant figure you can trust.
Getting the final number with calculate_tax_liability
Before this MCP, if an invoice had a gross amount and two different deductions (say, state fees and service credits), you’d have to subtract them manually from the total before even applying tax. It was prone to human error.
Now, `calculate_tax_liability` handles that entire sequence internally. You provide the inputs, and it returns the final, calculated figure, complete with audit trail logic built into its function.
What you can do with this MCP connector
Calculating taxes isn't simple; it depends heavily on where the transaction happens and what services are involved. You shouldn't guess rates or rely on outdated spreadsheets. This MCP handles complex municipal tax rules, ensuring you calculate the Service Tax (ISS) correctly every time. It determines the proper rate for any given service type and location, verifies if withholding is required by law, and then computes the final amount due, factoring in deductions.
If your process involves multiple variables—like a gross income amount versus an allowable deduction—this tool makes sure the math is right. Since this MCP lives within Vinkius, you don't have to worry about connecting separate tax services; everything needed for compliant financial calculations is centralized here.
019ed0fb-42e8-72f0-a349-3a036f2a7e5a 
How ISS Calculator MCP Works
- 1 First, run a check to see if tax withholding is required for the specified service and location.
- 2 Next, use the tool to pull the exact tax rate percentage from the municipality database based on the service type.
- 3 Finally, pass all gathered data (gross amount, deductions, and rates) into the calculation function to get the final liability figure.
The bottom line is, you feed it your transaction details, and it spits out a legally compliant tax number.
Who Is ISS Calculator MCP For?
Compliance officers and finance analysts who spend hours cross-referencing local municipal codes are the primary users. If billing accuracy based on jurisdiction is mission-critical, this MCP saves you from costly mistakes.
Needs to verify that a client's invoice includes the correct ISS rate for their specific service area and type.
Must validate internal processes to ensure tax withholding status is checked before any payment record is finalized.
Calculates the final, accurate taxable base for quarterly reporting, incorporating various deductions and local rates.
What Changes When You Connect
- Accuracy: Never guess a rate again. Use
get_applicable_rateto pull the precise Service Tax percentage from any municipality, eliminating manual lookups and compliance risk. - Compliance Check: Before finalizing billing, use
check_withholding_statusto instantly confirm if tax must be withheld at source, preventing payment rejection issues. - Final Calculation: Don't just get a rate; calculate the final amount. The
calculate_tax_liabilitytool handles deductions and gross amounts in one step for guaranteed accuracy. - Jurisdictional Scope: This MCP supports complex geographical rules. It doesn't care if you're billing across state lines, as long as you specify the municipality.
- Workflow Control: You can enforce a strict compliance sequence—checking status first, then rate, then liability—ensuring no step is skipped.
Real-World Use Cases
Processing an Invoice from a New Client
A billing specialist receives a service invoice for Belo Horizonte. They ask their agent to check the tax rate and calculate liability. The agent calls get_applicable_rate first, then uses calculate_tax_liability, delivering the correct ISS total instantly, preventing an undercharge dispute.
Verifying Payment Requirements
A finance analyst is setting up a payment for construction services. Before paying out, they query their agent to run check_withholding_status for the specific region, confirming if local law requires them to deduct tax upfront.
Handling Deductions on High-Value Services
A company processes a large IT service payment in Sao Paulo. They tell their agent to run calculate_tax_liability, supplying the gross amount and the allowed deduction. The tool returns the exact net tax liability, factoring everything correctly.
Comparing Tax Rules Across Cities
A compliance officer needs a quick comparison of ISS rates for cleaning services between Rio de Janeiro and São Paulo. They use get_applicable_rate twice in sequence to pull two distinct tax percentages, quickly building a report.
The Tradeoffs
Calculating without checking rules
Manually calculating the final tax amount based only on the general service rate they remember. They might miss required withholding status.
→
Always run check_withholding_status first to validate compliance, then use get_applicable_rate, and finally feed everything into calculate_tax_liability.
Using a single rate for all services
Applying the general city tax rate (e.g., 10%) to every invoice, even if specific service types have unique municipal rates.
→
You must call get_applicable_rate with both the municipality name and the exact service type to get the correct percentage.
Ignoring deductions
Calculating tax only on the gross amount, forgetting that certain expenses are legally deductible from the taxable base.
→
Use calculate_tax_liability and include the deduction amount in the call parameters. It handles the netting process for you.
When It Fits, When It Doesn't
You should use this MCP if your core need is calculating Service Tax (ISS) liability where compliance with specific municipal rates and withholding laws matters. The workflow is always: check status, get rate, calculate final tax amount. Don't use it if you are trying to manage payroll taxes or handle general corporate income tax reporting; those require different accounting models. If your system needs to know if a deduction reduces the taxable base before calculation, this MCP is built for that specific flow.
Common Questions About ISS Calculator MCP
How do I use calculate_tax_liability to find my tax amount? +
Call calculate_tax_liability and provide the municipality name, service type, gross amount, and any deduction amounts. It returns the final taxable base and the resulting tax liability.
What if I don't know the rate for my location? Should I use get_applicable_rate first? +
Yes. Always start by calling get_applicable_rate. This ensures you pull the correct percentage, which is mandatory before running any calculation.
Does check_withholding_status cover all tax rules? +
The check_withholding_status tool verifies if withholding is required for a specific service and location. It's the necessary first step to validate compliance before proceeding.
Can I calculate tax liability without knowing deductions? +
You can, but it’s not recommended. To get the most accurate figure, pass the deduction amount (even if zero) into calculate_tax_liability to ensure all factors are considered.
What happens if I use calculate_tax_liability with an unsupported service type? +
The MCP handles input validation and sends back a clear error message. You'll need to check the required service codes or adjust your inputs before recalculating.
Is the tax rate retrieved by get_applicable_rate always current with new municipal ordinances? +
The MCP is built using regularly updated databases that reflect major municipal changes. If a rate changed recently, check the documentation for the exact update cycle.
Do I need to run get_applicable_rate before calling calculate_tax_liability? +
While you can call them separately, confirming the applicable rate first ensures your calculation uses the most accurate tax percentage available in the system.
Does check_withholding_status require specific credentials or logins for a municipality? +
No. This MCP pulls required withholding information from established public domain rules within Vinkius, so no special client credentials are necessary to run check_withholding_status.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
