# Salary Net Calculator MCP

> Salary Net Calculator calculates your actual take-home pay by handling all mandatory deductions like INSS, IRRF, and FGTS. It lets you model salary changes against current tax laws instantly, so you know exactly what your net income will be before the paycheck hits. This MCP gives you full visibility into payroll compliance.

## Overview
- **Category:** finance
- **Price:** Free
- **Tags:** salary, taxes, payroll, inss, irrf, fgts

## Description

Figuring out net pay used to mean cross-referencing bulky government tax tables, calculating deductions manually, and praying you didn't miss a progressive bracket—it was a headache. Now, you can feed any gross salary number into this toolset and get the final, compliant take-home amount immediately. It handles all three major deduction types (INSS, IRRF, FGTS) while keeping up with changing tax rules. You don't just get an estimate; you get a precise breakdown of how much is taken out and why. Because we host this MCP on Vinkius, you connect once to access thousands of financial tools across different industries, making it your central payroll hub.

## Tools

### calculate_net_payroll
Calculates the final take-home salary amount after applying INSS and IRRF deductions to a given gross pay.

### compare_salary_scenarios
Compares two different starting salary amounts to show you exactly how much your net pay will change between them.

### get_tax_configuration
Retrieves the current, live tax rules and deduction rates for INSS, IRRF, and FGTS.

## Prompt Examples

**Prompt:** 
```
Calculate net salary for a gross pay of 5000.
```

**Response:** 
```
For a gross salary of 5000, your net salary is 4250.50 after INSS and IRRF deductions.
```

**Prompt:** 
```
Show me the current tax configuration summary.
```

**Response:** 
```
The current configuration uses progressive brackets for INSS and IRRF, with a fixed FGTS rate of 8%.
```

**Prompt:** 
```
Compare a gross salary of 3000 to 5000.
```

**Response:** 
```
Comparing 3000 to 5000 results in a net pay difference of 1250.50 and an effective rate change of -1.5%.
```

## Capabilities

### Calculate Net Pay
Determines the final take-home salary after applying all necessary tax and mandatory deductions.

### Check Current Tax Rules
Retrieves the latest operational configuration for INSS, IRRF, and FGTS rates needed for accurate calculations.

### Model Salary Changes
Compares two different gross salary amounts to calculate how much the net pay will change between them.

## Use Cases

### Reviewing Employee Raises
A payroll manager needs to propose a 10% raise for a department. Instead of calculating every person individually in Excel, they use `compare_salary_scenarios` with the old and new gross pay rates. The agent instantly reports the total net pay increase across all employees, making budget approval fast.

### Onboarding New Hires
An HR coordinator is talking to a potential employee who asks what their actual take-home salary will be. They run `calculate_net_payroll` with the offer amount and get the exact net pay, including all deductions, giving the candidate immediate confidence.

### Auditing Payroll Records
A bookkeeper suspects a previous payroll cycle might have used outdated tax rates. They first run `get_tax_configuration` to verify the active ruleset, then use that output to validate all historical records.

### Budgeting for Q3 Compensation
A finance director needs to see how much net pay their department will receive if they budget for two potential bonus levels (low and high). They feed both scenarios into the comparison function, giving a clear financial range.

## Benefits

- Stop guessing deductions. The `calculate_net_payroll` tool provides a precise, compliant net salary figure by handling complex progressive tax brackets.
- Model options risk-free. Use the comparison function to see exactly how much changing one number (like a bonus or raise) affects your bottom line without running multiple calculations.
- Stay compliant with minimal effort. The `get_tax_configuration` tool gives you instant access to the latest INSS, IRRF, and FGTS rates so your payroll is always accurate.
- Save hours of manual work. You eliminate the need for spreadsheet lookups and cross-referencing tax code pages every time a salary changes.
- Know what employees really care about. Give candidates an accurate net pay projection immediately, improving trust during the hiring process.

## How It Works

The bottom line is that this MCP takes complex tax compliance and turns it into a simple, verifiable calculation flow.

1. First, check the current tax rules using the configuration tool. This sets your baseline for compliance.
2. Next, run the main payroll calculator with the specific gross salary you need to analyze.
3. Finally, if you're comparing options, use the scenario comparison tool to see the net pay difference between two different starting salaries.

## Frequently Asked Questions

**How do I use the `calculate_net_payroll` tool?**
You provide the MCP with a single gross salary amount. The tool then returns your precise net pay, automatically subtracting INSS and IRRF based on current tax law.

**I need to know the latest deduction rates; how do I use `get_tax_configuration`?**
Simply prompt the MCP with 'show tax configuration.' This tool pulls the live, necessary rates for INSS, IRRF, and FGTS directly from the system's current database.

**How does `compare_salary_scenarios` work?**
This tool takes two separate gross salary figures. It runs both through the full deduction process and shows you a clear report of the net pay difference between them.

**`calculate_net_payroll` handles all tax deductions, right?**
Yes. The main calculation tool applies progressive brackets for INSS and IRRF while also accounting for FGTS, giving you a complete picture of your take-home pay.

**What should I do if I get an error running `calculate_net_payroll`?**
The system sends a detailed error code and message. This usually means the input data is missing or formatted incorrectly, so you just need to check your required fields.

**Can `calculate_net_payroll` process deductions beyond INSS, IRRF, and FGTS?**
No. This MCP focuses narrowly on calculating net salary based on the standard progressive brackets for INSS and IRRF, plus the fixed rate for FGTS. It won't account for other voluntary dues.

**Before I use `compare_salary_scenarios`, how do I confirm the latest tax rules are active?**
First, call `get_tax_configuration`. This tool pulls the current official brackets for INSS and IRRF. You'll want to check this before comparing salaries to ensure accuracy.

**Are there limitations on how frequently I can use `calculate_net_payroll`?**
No explicit rate limits restrict standard usage through Vinkius. The service is designed for high availability, so you shouldn't run into throttling issues.