# ISS Calculator MCP for AI Agents AI Agent Connect

> ISS Calculator helps you figure out Service Tax (ISS) based on specific municipality rates and service types. It allows you to quickly find tax percentages, determine if tax must be withheld at the source, and compute final taxable bases including allowed deductions. It's built for anyone who needs to handle complex regional tax math without the manual research.

## Overview
- **Category:** finance
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_HlSPdLjtJSxPtEgVdNPHFyH8MRO0Ac1yUuvQ55cL/ai-agent-connect
- **Tags:** iss, tax, municipality, finance, calculator

## Description

This Connector lets you handle the headaches of municipal tax compliance without having to dig through endless tax code websites or maintain massive spreadsheets. If you're providing services across different regions, you know that every city has its own rules for Service Tax (ISS). You might need to know the exact percentage for a specific job, like IT consulting versus construction, or you might need to know if the client is required to withhold tax at the source. This Connector takes that research off your plate. You can just ask your agent to check the rules for a specific municipality and service type, and it gives you the facts immediately. It also does the heavy lifting on the math, calculating the final tax liability while accounting for any allowed deductions. Instead of doing the manual arithmetic and cross-referencing multiple sources, you get a clear, final number for your invoice or report. By adding this to your workflow via the Vinkius catalog, you turn a tedious research task into a quick query. It keeps your billing accurate and your compliance on track, whether you're a freelancer sending a single invoice or a finance manager handling hundreds of regional service contracts. You no longer have to worry about missing a local requirement or miscalculating a deduction that could lead to an audit later.

## Tools

### calculate_tax_liability
Compute the final taxable base and tax amount including any allowed deductions. This gives you a precise number for your records.

### check_withholding_status
See if you need to withhold tax at the source for a specific service. This helps you avoid unexpected payment shortfalls.

### get_applicable_rate
Get the specific tax percentage for a service in a given municipality. Use this to stay compliant with local rules.

## Prompt Examples

**Prompt:** 
```
What is the tax rate for IT services in Sao Paulo?
```

**Response:** 
```
### Tax Rate Information

| Service Type | Municipality | Tax Rate |
| :--- | :--- | :--- |
| **IT Services** | Sao Paulo | **5.0%** |

*Note: This rate is specific to the municipality of Sao Paulo for IT-related service categories.*
```

**Prompt:** 
```
Calculate the tax for a 1000 gross amount cleaning service in Rio de Janeiro with 200 deduction.
```

**Response:** 
```
### Tax Calculation Summary

*   **Gross Amount:** $1,000.00
*   **Allowed Deduction:** $200.00
*   **Taxable Base:** $800.00
*   **Applicable Rate (Rio):** 3.0%

**Final Tax Liability: $24.00**

*The total tax amount is calculated based on the taxable base of $800.00.*
```

**Prompt:** 
```
Is withholding required for construction services in Belo Horizonte?
```

**Response:** 
```
### Withholding Status

**Yes**, tax withholding is required at the source for **Construction** services in the municipality of **Belo Horizonte**. 

*You should ensure the contract reflects the correct withholding percentage to avoid payment shortfalls.*
```

## Capabilities

### Find municipal tax rates
Get the specific tax percentage for a service in a given municipality.

### Check withholding requirements
See if you need to withhold tax at the source for a specific service type.

### Compute final tax liability
Calculate the final taxable base and tax amount including allowed deductions.

### Apply allowed deductions
Automatically subtract eligible deductions from the taxable base.

### Determine service-specific percentages
Identify how different categories of work are taxed in different locations.

## Use Cases

### Freelancer invoicing
A freelance software developer needs to invoice a client in a different city. They ask their agent to find the specific Service Tax (ISS) rate for IT services in that municipality to ensure the quote is accurate.

### Construction withholding
A construction firm is planning a project in a new region. They ask their agent to check if they need to withhold tax at the source for construction services to avoid any unexpected payment shortfalls.

### Regional finance reporting
A finance manager needs to run a quarterly report on regional tax liabilities. They ask their agent to calculate the total tax for 50 different service types across 10 different municipalities.

### Quote calculation
A cleaning service owner is drafting a contract for a large commercial space. They ask their agent to calculate the final tax liability for the job, making sure to include a specific allowed deduction.

## Benefits

- Stop guessing rates: Use `get_applicable_rate` to get precise numbers for every city instantly.
- Avoid payment surprises: `check_withholding_status` ensures you know exactly how much to collect from clients.
- Precise invoicing: `calculate_tax_liability` handles the math on deductions so your quotes are always accurate.
- Faster regional expansion: Scale your services to new cities without manually researching local tax codes every time.
- Audit-ready records: Keep consistent tax calculations for every service type across different jurisdictions.
- Automate complex math: Let the Connector handle taxable base calculations and deductions for every unique service.

## How It Works

The bottom line is you get accurate tax figures for any service location without manual research.

1. Tell your agent the municipality and the type of service you're providing.
2. The agent identifies the correct tax rate and checks for withholding status.
3. You get a final tax amount that includes any applicable deductions.

## Frequently Asked Questions

**How does ISS Calculator help with municipal taxes?**
It automatically finds the specific tax rates for different cities and service types. This means you don't have to manually search for local tax codes every time you send an invoice.

**Can I use ISS Calculator for different service types?**
Yes, it handles various categories like IT services, construction, and cleaning. It identifies the correct percentage based on the specific work you're doing.

**Does ISS Calculator handle tax deductions?**
Yes, it can compute the final tax liability by accounting for allowed deductions. This ensures your final quote is accurate and doesn't overcharge your clients.

**How does ISS Calculator help with withholding status?**
It tells you whether the law requires tax to be withheld at the source for a specific job. This helps you avoid surprises when you receive your final payment.

**Can I use ISS Calculator for regional expansion?**
It's perfect for that. You can quickly check the tax rules for any new municipality you enter, making it much easier to scale your services across different regions.

**Is ISS Calculator accurate for different cities?**
Yes, it pulls specific rates for different municipalities. It's designed to give you precise local data so you stay compliant with regional requirements.

**How can I find the tax rate for a specific city?**
You can use the `get_applicable_rate` tool by providing the municipality name and the service type.

**Does the calculator handle tax withholding?**
Yes. Use `check_withholding_status` to see if the service taker is responsible for paying the tax at source.

**Can I include deductions in my calculation?**
Yes, using `calculate_tax_liability`, you can provide a deduction amount. The tool will only apply it if the service type allows for deductions in that municipality.