# JLU Salary & Budget Calculator (MCP Server)

This tool allows your AI assistant to calculate estimated salaries and total employer costs for project staff at Justus Liebig University (JLU) Giessen.

It automatically handles the university's official salary tables, compounding tariff increases, and complex German social security and taxation rules.

---

## What It Calculates

The calculator supports three types of university staff:

1. **Student Assistants (Hilfskräfte)**
   * Calculates monthly hourly wages based on education level.
   * Handles student social security rules (including Minijobs and Midijob pension contributions).
   * Computes the total cost to the university.

2. **Employees Covered by Collective Agreements (Tarifbeschäftigte - TV-H)**
   * Looks up official TV-H salary grades (E1 to E16) and stages.
   * Tracks stage progression (getting raises automatically over time).
   * Computes full employer contributions (Health, Pension, Unemployment, and Care insurance).
   * Includes VBL additional pension, U2 levies, and the November Christmas bonus (Jahressonderzahlung).

3. **Civil Servants (Beamtinnen und Beamte)**
   * Looks up Besoldungsgruppen (A6 to A16) and stages.
   * Computes family allowances for spouses and children (including multi-child rules).
   * Includes annual special payments and holiday bonuses (Sonderzahlung/Urlaubsgeld).

---

## How to Use It with an AI Assistant

Once connected, you can ask your AI assistant questions in plain language, such as:

* *"How much will it cost to hire a student assistant for 40 hours a month from March 2026 to February 2027?"*
* *"What are the monthly and total employer costs for a TV-H E13 staff member starting at Stage 2 for a 2-year contract?"*
* *"Compute the budget for a civil servant in grade A12, stage 3, with 2 children, working 50% time for all of 2027."*

The AI will use the calculator tools in the background to provide 100% accurate, spreadsheet-validated calculations.

---

## Quick Start (For Administrators / Developers)

### Requirements
* Node.js (version 18 or higher)

### Setup & Run
1. Install dependencies:
   ```bash
   npm install
   ```
2. Build the application:
   ```bash
   npm run build
   ```
3. Start the server:
   ```bash
   npm start
   ```

### Connecting to Claude Desktop
Add the following to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "jlu-salary-calculator": {
      "command": "node",
      "args": ["/absolute/path/to/Entgeltrechner-MCP/dist/index.js"]
    }
  }
}
```
*(Replace `/absolute/path/to/` with the actual path to where this folder is saved on your computer).*