# DECORE Simulator MCP

> DECORE Simulator calculates and validates your income declarations against regulatory standards. It accurately aggregates diverse revenue streams—including Pro-labore, Profit Distribution, and Autonomous income—and determines exactly what portion of that total falls under tax law. Use this MCP to ensure your financial reports meet compliance thresholds before filing.

## Overview
- **Category:** finance
- **Price:** Free
- **Tags:** revenue, taxation, income-validation, financial-tools, regulatory-compliance

## Description

This specialized tool handles the hard math behind proving your declared income is compliant. You can feed it raw data, and the system aggregates every revenue stream you need—Pro-labore, Profit Distribution, Autonomous income, and more. It calculates the total monthly intake and then figures out which parts are exempt versus taxable. This process stops compliance guesswork in its tracks. Instead of manually checking rules across multiple spreadsheets, you run a single validation to see if your numbers exceed safe regulatory limits or if they need extra documentation attached. You connect this MCP through Vinkius, accessing it via any compatible agent, and you get an immediate status report on your financial declarations.

## Tools

### validate_income_compliance
Checks if any given income amount falls outside established regulatory limits.

### calculate_total_monthly_revenue
Aggregates all source inputs to determine the total monthly revenue and its breakdown by type.

### compute_taxable_burden
Calculates precisely how much of a given income is legally subject to taxes.

## Prompt Examples

**Prompt:** 
```
Calculate my total revenue with 5000 pro-labore, 2000 distribution, and 1000 autonomous income.
```

**Response:** 
```
Your total monthly revenue is 8000. The composition is 62.5% Pro-labore, 25% Profit Distribution, and 12.5% Autonomous income.
```

**Prompt:** 
```
Check if my income of 10000 pro-labore is compliant.
```

**Response:** 
```
The status is Critical because the Pro-labore amount exceeds the allowed threshold.
```

**Prompt:** 
```
How much of my 5000 total income is taxable?
```

**Response:** 
```
The taxable portion of your income is 5000, while the exempt portion is 0.
```

## Capabilities

### Determine total monthly revenue
Aggregates all categorized income streams to give you a single, accurate view of the month's earnings.

### Validate regulatory compliance status
Checks specific income amounts against defined tax and reporting boundaries for immediate pass/fail feedback.

### Calculate taxable portions
Separates total revenue into clear components: the amount subject to tax, and the exempt amount.

## Use Cases

### Quarterly tax filing review
An accountant needs to file taxes using three separate payroll inputs (Pro-labore, Distribution, Autonomous). Instead of manually summing and checking rules in Excel, they ask their agent to run `calculate_total_monthly_revenue` first. This gives them the total monthly figure, which is then fed into `compute_taxable_burden` for a single, accurate tax liability report.

### Investigating an unusual income spike
A business owner sees a sudden, large influx of funds. They aren't sure if it violates any local compliance rules. They use `validate_income_compliance` on the suspicious amount immediately to get a red-flag status before doing any other calculations.

### Preparing for an audit
A company needs to prove that all income reported over the last quarter was accounted for. They run `calculate_total_monthly_revenue` across all months and then use the aggregated data to calculate the total tax burden using `compute_taxable_burden`, providing a clear, auditable trail.

### Structuring new compensation
A company is adding a new revenue source. They must ensure this new stream doesn't push existing income past regulatory limits. They use `validate_income_compliance` to model the impact of the new funds before HR implements them.

## Benefits

- Stop guessing about compliance. Use `validate_income_compliance` to instantly check if specific amounts, like Pro-labore or Profit Distribution, meet legal thresholds.
- Get a true picture of your cash flow using `calculate_total_monthly_revenue`. It doesn't just sum numbers; it shows the exact percentage breakdown of every revenue stream.
- Eliminate manual tax calculations. The MCP calculates the precise portion of income subject to tax, saving you time and risk with `compute_taxable_burden`.
- The process is auditable. By staging the data through validation, calculation, and burden computation, you build a traceable compliance report for any audit.
- Handle mixed revenue types easily. Whether it's Autonomous income or standard wages, the system treats them under one compliant umbrella.

## How It Works

The bottom line is you feed it raw numbers in stages: validate inputs, calculate totals, then determine tax liability.

1. Input your raw financial data sets. You first use the `validate_income_compliance` tool to check if individual income amounts are already within legal boundaries.
2. Next, run the `calculate_total_monthly_revenue` tool. This combines all validated streams (Pro-labore, Profit Distribution, etc.) into one master revenue figure and shows its precise composition.
3. Finally, pass that aggregated total to `compute_taxable_burden`. The system returns the final breakdown of how much of your income is legally subject to tax.

## Frequently Asked Questions

**How does DECORE Simulator handle Pro-labore income?**
The MCP includes specialized handling for varied streams like Pro-labore, ensuring it is correctly aggregated into the total monthly revenue before compliance rules are applied.

**What if my income source isn't listed? Can DECORE Simulator still calculate tax?**
It calculates based on what you provide. You must pass the raw data through `calculate_total_monthly_revenue` first; the MCP then structures that input for compliance checking.

**Is validate_income_compliance only for simple checks?**
No, it validates if amounts fall outside regulatory boundaries. This is the critical first step to ensure your raw data meets legal standards before any final reporting happens.

**Which tool should I use to get the final tax number?**
You must use `compute_taxable_burden`. This tool takes the total, compliant revenue figure and outputs the exact portion that is legally subject to taxation.

**When using `calculate_total_monthly_revenue`, what input data types do I need to provide?**
You must supply structured pairs of income type (like Pro-labore or Profit Distribution) and the corresponding numerical amount. This format ensures the tool correctly aggregates all revenue streams for an accurate total.

**If the income figures cause an error when running `validate_income_compliance`, how will I be notified?**
The MCP doesn't just fail; it returns a detailed error message. This message specifies exactly which regulatory threshold was breached and gives context on why the compliance check failed.

**Is there a limit to how often I can use `compute_taxable_burden`?**
There are no artificial rate limits for standard usage. The tool processes calculations very quickly, generally completing within seconds of receiving the input data.

**When I run any calculation involving this MCP, does Vinkius store my raw income data?**
No. The MCP runs computations securely in memory and only returns the final calculated result. Your original, sensitive input data is not saved or linked to an account.