# Thirteenth Salary Calculator MCP

> Thirteenth Salary Calculator calculates your 13th-month salary installment. It handles complex payroll math, determining proportional earnings based on months worked, applying progressive social security deductions, and calculating final income tax withholdings for both installments.

## Overview
- **Category:** finance
- **Price:** Free
- **Tags:** salary, calculator, taxes, payroll, social-security, income-tax

## Description

Calculating a 13th-month paycheck is messy work. You need to account for partial years of service, then layer in multiple mandatory deductions like social security and income taxes. This MCP manages that complexity entirely. It gives you the full financial picture—gross pay, total tax withholdings, net take-home amounts, and a clear split between the first and second payments. Instead of juggling spreadsheets or relying on siloed systems, your agent handles the entire calculation sequence in one go. You just need to provide basic inputs; the system figures out all the progressive math required for compliance. Since Vinkius hosts this MCP, you connect it once from any compatible AI client and instantly have access to sophisticated payroll logic that keeps your accounts accurate.

## Tools

### compute_social_security_deduction
Calculates the required social security withholding amount for the payment.

### compute_income_tax_deduction
Figures out the necessary income tax deduction based on salary and work period.

### calculate_proportional_gross
Determines the gross amount of the 13th-month pay by calculating a proportion based on months worked.

### get_thirteenth_breakdown
Generates a full, detailed report showing all gross amounts, deductions, and net payments for both installments.

## Prompt Examples

**Prompt:** 
```
Calculate my 13th salary if my monthly base salary is 3000 and I worked 8 months this year.
```

**Response:** 
```
Based on a monthly salary of 3,000.00 and 8 months worked, your total proportional gross amount is 2,000.00.
```

**Prompt:** 
```
What will my second installment be if I earn 5000 per month and worked 12 months?
```

**Response:** 
```
For a full year of work at 5,000.00 per month, your second installment after all social security and income tax deductions will be 4,250.50.
```

**Prompt:** 
```
Show me the full breakdown for a salary of 2500 and 6 months worked, with payments in November and December.
```

**Response:** 
```
Your total gross amount is 1,250.00. After deductions, your net total is 1,180.00. The first installment in November will be 625.00 and the second in December will be 555.00.
```

## Capabilities

### Calculate proportional gross earnings
Determines the total base salary amount based on how many months an employee worked during the year.

### Compute social security deductions
Calculates mandatory contributions for social security withholding based on current law.

### Compute income tax withholdings
Determines the final required amount to be deducted for federal and state income taxes.

### Get full salary breakdown
Provides a complete, itemized overview of the 13th-month salary, including gross totals, all deductions, and net pay for both installments.

## Use Cases

### Processing mid-year payroll adjustments
A payroll manager needs to calculate 13th salary for new hires who only worked six months this year. They ask their agent, and it uses `calculate_proportional_gross` first, then runs the full breakdown via `get_thirteenth_breakdown`. The result immediately shows accurate net pay split across two payments.

### Auditing tax compliance for a client
An accountant needs to verify that both social security and income taxes were properly applied. They run the full workflow, confirming that `compute_social_security_deduction` and `compute_income_tax_deduction` are correctly linked after the proportional gross is established.

### Verifying split payment amounts
An HR manager needs to show an employee exactly how their 13th salary is divided into two payments. They use `get_thirteenth_breakdown`, which outputs the precise net figures for November and December, matching the payroll schedule.

### Calculating pay for temporary staff
A small business owner needs to run a quick estimate for part-time workers. They input low base salary data; the agent uses `calculate_proportional_gross` and immediately gives them an accurate tax liability estimation before running the final breakdown.

## Benefits

- Avoid manual errors by automating the entire sequence. Instead of calculating gross pay, then manually deducting taxes, you let the tool run `calculate_proportional_gross` first, ensuring a clean starting point for all subsequent deductions.
- Guarantee compliance with tax law. It handles both social security and income tax withholding automatically. You don't have to worry about mixing up formulas or forgetting the progressive deduction steps when using `compute_social_security_deduction` and `compute_income_tax_deduction`.
- Get a full picture in one go. Forget piecing together data from different sheets. The single call to `get_thirteenth_breakdown` gives you the net total, tax breakdown, and gross amount—all on one page.
- Handle partial years easily. You don't need complex formulas for proportional pay. Just input months worked, and `calculate_proportional_gross` handles the scaling automatically.
- Save time on reconciliation. Because it combines all steps into a single workflow, your audit trail is clean and traceable. It drastically cuts down the time spent confirming every number.

## How It Works

The bottom line is that you get a complete, legally structured payroll report without doing any manual math or data merging.

1. You start by inputting base salary data and the number of months worked. The system first uses `calculate_proportional_gross` to find the total gross amount.
2. Next, it runs the two mandatory deduction tools: `compute_social_security_deduction` and `compute_income_tax_deduction`. These subtract all required taxes from the gross total.
3. Finally, calling `get_thirteenth_breakdown` compiles everything into a single report showing the net pay for both the first and second installments.

## Frequently Asked Questions

**How is the proportional gross salary calculated?**
The `calculate_proportional_gross` tool calculates this by dividing your annual base salary by twelve and multiplying it by the number of full months worked in the current year.

**Does the calculator include tax deductions?**
Yes, you can use `compute_social_security_deduction` and `compute_income_tax_deduction` to find the specific amounts deducted from your gross salary.

**Can I see a full breakdown of both installments?**
Yes, the `get_thirteenth_breakdown` tool provides a complete summary including gross amount, total deductions, net amount, and details for both installments.

**How does `compute_social_security_deduction` calculate deductions?**
It applies current social security law and your working period. The tool takes your base salary and the number of months worked to ensure an accurate mandatory contribution amount.

**What input is required for `calculate_proportional_gross`?**
You must provide a numeric value for both the monthly salary and the total months worked. The tool processes these two key numbers directly to determine your proportional gross pay.

**Can `compute_income_tax_deduction` handle different tax brackets?**
Yes, it incorporates progressive income tax rules into its calculation. This ensures that the deduction correctly reflects the total annual earnings against current withholding standards.

**What if I need to calculate salary for non-standard periods using `get_thirteenth_breakdown`?**
You can specify custom start and end dates when calling this MCP. This lets you generate a full financial breakdown even if your work period doesn't align with standard payment cycles.

**What happens if I submit invalid data to the Thirteenth Salary Calculator?**
If the input is malformed or missing required parameters, the MCP will return a specific error code. You should check that all provided salary and duration metrics are valid numbers.