# Spain IRPF Calculator MCP

> Spain IRPF Calculator determines your full Spanish Personal Income Tax (IRPF) liability. It handles complex tax law by calculating taxable bases, applying progressive state quotas, and factoring in regional community modifiers. This MCP helps you find the exact net tax due after accounting for personal deductions.

## Overview
- **Category:** finance
- **Price:** Free
- **Tags:** spain, irpf, tax, calculator, finance

## Description

Figuring out your final IRPF is complicated because Spanish tax law layers multiple rules on top of each other, from general income to savings income, and then adds regional variations. Your agent uses this MCP to perform a full calculation that accounts for every layer. It first determines the precise taxable amounts for both General and Savings pools after all deductions are accounted for. Next, it computes the portion owed specifically to the Spanish State using progressive national brackets. The process continues by applying any additional tax liability from your specific Autonomous Community and then adjusting for personal reliefs related to age or dependents. Finally, it consolidates everything—the state quota, regional adjustments, and personal reductions—to give you one accurate net tax number. Vinkius hosts this specialized calculation engine, letting your AI client access a full workflow that makes complex tax compliance simple.

## Tools

### calculate_personal_reductions
Calculates the total tax relief available based on personal circumstances like age or family size.

### compute_state_quota
Figures out the specific portion of the tax that must be paid directly to the Spanish State government.

### calculate_taxable_bases
Determines the remaining amounts for both General and Savings income pools after all deductions are taken out.

### compute_regional_tax
Calculates any additional tax amount that must be paid to a specific regional Autonomous Community.

### get_final_tax_determination
Puts all the previous calculations together to deliver the total gross and net tax liability figure.

## Prompt Examples

**Prompt:** 
```
Calculate the taxable bases for a gross general income of 30,000 and savings income of 5,000, with 2,000 in general deductions and 500 in savings deductions.
```

**Response:** 
```
The taxable general base is 28,000 and the taxable savings base is 4,500.
```

**Prompt:** 
```
What is the state tax liability for a taxable general base of 25,000?
```

**Response:** 
```
The calculated state tax liability for a taxable general base of 25,000 is 4,250.
```

**Prompt:** 
```
Calculate the final tax determination if state liability is 4,000, regional liability is 500, total reductions are 1,200, and taxable general base is 25,000.
```

**Response:** 
```
The gross tax liability is 4,500 and the net tax liability is 3,300.
```

## Capabilities

### Determine Taxable Income Bases
Calculates the exact amounts remaining for General and Savings income pools after applying statutory deductions.

### Calculate State Tax Quota
Determines the specific portion of tax owed directly to the Spanish central government.

### Apply Regional Tax Adjustments
Computes any additional tax liability imposed by a user's specific Autonomous Community.

### Calculate Personal Deductions
Finds the total amount of tax relief based on personal circumstances, such as age or dependents.

### Finalize Total Tax Liability
Consolidates all preceding calculations to deliver a single gross and net tax figure.

## Use Cases

### Determining tax due after a salary change
A client changes jobs and asks their agent what their new net pay will be. The agent uses `calculate_taxable_bases` first, then runs through the full chain of state/regional calculations, finally using `get_final_tax_determination` to provide the exact final withholding amount.

### Comparing tax burdens across regions
An analyst wants to compare filing taxes in two different Autonomous Communities. They run the core calculation twice, specifically calling `compute_regional_tax` for each location, allowing them to quantify the exact difference imposed by regional law.

### Tax planning with deductions
A user asks their agent to see how much tax they save if they have extra dependents. The agent executes `calculate_personal_reductions` against the existing tax profile, showing the immediate reduction in net liability.

### Verifying a full IRPF filing
A professional needs to validate a completed tax return. They feed all known income and deductions into `calculate_taxable_bases`, then combine this with state (`compute_state_quota`) and regional figures to verify the final net figure using `get_final_tax_determination`.

## Benefits

- Get the precise net tax liability. Instead of just getting a gross amount, using `get_final_tax_determination` consolidates state quota, regional taxes, and reductions into one final number.
- Handle income variations accurately. The tool uses `calculate_taxable_bases` to separate General and Savings incomes before applying deductions, which is key for Spanish law compliance.
- Account for regional differences. Never forget the local tax modifiers; `compute_regional_tax` ensures that your specific Autonomous Community's additions are included in the final figure.
- Factor in personal relief easily. Use `calculate_personal_reductions` to automatically account for age or dependents, ensuring you claim every eligible deduction.

## How It Works

The bottom line is that this MCP handles the entire multi-step workflow of Spanish IRPF calculation, giving you a single, accurate answer instead of several disconnected numbers.

1. You input the core financial data, including general income, savings income, and any initial deductions.
2. The MCP runs several sequential tools: first establishing the taxable bases, then calculating the state quota and regional adjustments, all while factoring in personal reductions.
3. Your agent receives a final determination, providing both the total gross tax liability and the net amount due.

## Frequently Asked Questions

**How does the Spain IRPF Calculator handle state vs. regional taxes?**
It handles this by first computing the base quota owed to the Spanish State using `compute_state_quota`, and then running `compute_regional_tax` separately. The MCP combines these two figures later in the final determination.

**Can I calculate tax if my income comes from savings?**
Yes, the system is designed for this. You must use `calculate_taxable_bases` to separate and determine the taxable amounts for both General and Savings pools before any other calculation runs.

**What is required to get a net tax liability?**
You need more than just income. You must run `calculate_personal_reductions` to account for dependents, age, or disability, which are crucial factors in determining the final amount owed.

**What if I only know my gross income? Can I use the Spain IRPF Calculator?**
No. The calculator needs more than just gross income; it requires you to provide deduction amounts so that `calculate_taxable_bases` can accurately determine your actual taxable income.

**Does this MCP handle tax for non-residents of Spain?**
The tool is built around the complex framework of Spanish law, which includes regional modifiers. Always confirm if your specific residency status affects the calculation method you use with `compute_regional_tax`.