# Vacation Pay Calculator MCP

> Vacation Pay Calculator processes complex payroll calculations for employee time off. It accurately calculates your gross vacation pay, including constitutional bonuses and cash allowances. Plus, it handles tax withholdings and figures out your legal payment deadline in one place.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** vacation, payroll, salary, tax, calculator

## Description

Getting paid when you take vacation shouldn't feel like a math exam. This tool takes the variables—your base salary, how many days you’re using, and local labor law requirements—and calculates exactly what you should receive. It handles the tricky bits: figuring out that 1/3 constitutional bonus, calculating the value if you convert days to cash (abono pecuniário), and correctly withholding income tax (IRRF). You get a full breakdown of your pay, plus a definitive date for when the money must be in your account. If you're managing payroll or just figuring out your next paycheck, this is it. It runs these complex calculations reliably, giving you peace of mind without needing specialized HR software. When you connect to Vinkius, you get access to this and thousands of other services, all through one spot.

## Tools

### cash_allowance_value
Calculates the specific monetary value when converting paid days into a cash allowance.

### tax_deductions
Determines the required income tax withholding (IRRF) amount for payroll payouts.

### gross_vacation_pay
Calculates your total pay before deductions, including both the base vacation salary and any constitutional bonus.

### payment_due_date
Figures out the absolute deadline for when the final payment must be made to the employee.

## Prompt Examples

**Prompt:** 
```
How much will my gross vacation pay be if my salary is 3000 and I am taking 30 days?
```

**Response:** 
```
Your gross vacation pay is 4000.00, which includes a constitutional bonus of 1000.00.
```

**Prompt:** 
```
If I convert 10 days to cash with a salary of 3000, how much is the allowance?
```

**Response:** 
```
The value for your cash allowance (abono pecuniário) is 1000.00.
```

**Prompt:** 
```
What is the tax withholding for a total taxable income of 5000?
```

**Response:** 
```
The IRRF withholding amount is 450.00, leaving you with a net payable amount of 4550.00.
```

## Capabilities

### Calculate gross pay and bonuses
Determine the total base amount for vacation time off, including any required constitutional bonus.

### Value day conversions
See the exact monetary value when you convert paid days into cash allowances.

### Calculate tax deductions
Determine the precise amount withheld for income tax (IRRF) based on your total pay.

### Set payment deadline
Figure out the specific legal date by which the full vacation payout must be delivered.

## Use Cases

### Processing a large batch payout
A payroll specialist needs to calculate vacation payouts for 50 employees. Instead of running 50 separate calculations, they use the MCP to process all required data points at once: getting the `gross_vacation_pay`, checking tax deductions via `tax_deductions`, and confirming the final `payment_due_date` across the entire group.

### Handling employee leave requests
An HR manager receives an inquiry about converting 15 days of vacation to cash. They run the request through the MCP, using `cash_allowance_value` to give the employee a precise figure and confirming the pay timeline with `payment_due_date`.

### Auditing historical payroll records
A finance analyst reviews last quarter's payouts. They use the MCP to verify if the correct constitutional bonus was applied via `gross_vacation_pay`, ensuring the company met all legal requirements for that period.

### Onboarding new payroll staff
A new team member needs to understand how net pay is calculated. They use the MCP's comprehensive view to see how gross pay gets reduced by `tax_deductions` and allowances, making complex concepts easy to grasp.

## Benefits

- You eliminate payroll guesswork. Instead of manually calculating the gross amount, let `gross_vacation_pay` handle the base salary plus constitutional bonus automatically.
- Stop worrying about tax codes. The tool runs accurate income tax withholding (IRRF) calculations through `tax_deductions`, giving you a reliable net pay figure instantly.
- Avoid conversion errors. Use `cash_allowance_value` to get the precise dollar amount for turning unused days into cash, removing manual math from your workflow.
- Never miss a deadline again. The MCP provides a clear payment due date using `payment_due_date`, ensuring compliance with local labor laws.
- It's one source of truth. You run all components—gross pay, deductions, allowances, and dates—in one place instead of juggling multiple spreadsheets.

## How It Works

The bottom line is that it takes complex payroll rules and spits out clear numbers for gross pay, net pay, and deadlines.

1. You input your base salary and the number of days you're taking off.
2. The MCP runs a sequence of calculations: first, it determines your gross pay; then, it figures out tax deductions and cash allowance values. Finally, it sets the required payment due date.
3. You receive a comprehensive breakdown showing the total amount owed, the deductions taken out, and when you can expect to get paid.

## Frequently Asked Questions

**How does the `gross_vacation_pay` tool calculate the constitutional bonus?**
It incorporates the 1/3 constitutional bonus automatically into the gross amount. This means you don't have to add that specific labor law requirement manually; it just appears in your total.

**What if I need to know my payment deadline using `payment_due_date`?**
You input the vacation start date, and the tool returns the legal cutoff for paying out. This is critical because payroll must adhere to specific labor laws regarding timing.

**Does `tax_deductions` handle different tax rates?**
Yes, it calculates income tax withholding (IRRF) based on current parameters. It provides the exact deduction amount needed for accurate net pay reporting.

**Can I calculate cash allowance using `cash_allowance_value`?**
Absolutely. This tool takes your paid days and calculates their specific monetary value, which is necessary if you convert time off into a cash payout.

**When using `gross_vacation_pay`, what specific inputs does the tool require?**
The tool requires three core pieces of data for an accurate calculation: your base salary, total vacation days taken, and the constitutional bonus multiplier. Providing these ensures you get the correct gross pay amount.

**If I input conflicting or impossible date ranges for `payment_due_date`, how does the system respond?**
The MCP will return a clear validation error instantly. It specifically flags which dates conflict, allowing you to correct your vacation start and end points right away.

**If I need to run tax calculations for several periods, is that possible with `tax_deductions`?**
Yes, the tool handles multiple pay cycles in a single request. Just make sure your data payload includes the required start and end dates for every period you want taxed.

**How quickly does the `cash_allowance_value` function run when checking bulk conversions?**
The calculation is optimized and runs instantly, even with dozens of converted days. You get immediate results without noticeable lag, which makes it perfect for quick payroll checks.