# Overtime Income Planner MCP. AI Agent Connect

> Overtime Income Planner is a precision tool for calculating payroll outcomes. It handles complex pay structures including base rates, multiple overtime tiers, and shift differentials. You can determine exactly how many hours you need to work to hit a specific net income goal or get a full breakdown of your earnings after taxes.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_l7funS7vzYseR4wjmnpRMaXaxeUdgl7Iqq9IYJOk/ai-agent-connect
- **Tags:** payroll, overtime, tax, income, calculator

## Description

You can stop guessing what your paycheck will actually look like. This MCP handles the heavy lifting of payroll math, specifically for roles with complex overtime rules. Whether you deal with standard time-and-a-half, double time, or specific shift differentials, your AI client can process these variables instantly. It doesn't just look at gross pay; it factors in tax rates so you see the actual cash you'll have in your pocket. If you have a specific financial target, you can tell your agent exactly how much you need to take home, and it will calculate the necessary work hours to get you there. It's built for anyone who needs to navigate tiered overtime or variable pay rates without running manual spreadsheets every week.

## Tools

### calculate_required_hours
This tool tells you exactly how many hours you need to work to hit a specific net income target.

### get_gross_pay
Use this to find your total earnings before any taxes or deductions are taken out.

### get_net_pay
This tool calculates your final take-home pay after accounting for tax rates.

### get_payroll_summary
This provides a full breakdown of everything earned and taxed during a single pay period.

## Prompt Examples

**Prompt:** 
```
How much will I take home if I work 40 base hours and 10 overtime hours at $25/hr with a 20% tax rate?
```

**Response:** 
```
Your total net pay will be $1,200.00.
```

**Prompt:** 
```
How many hours do I need to work at $20/hr to take home $1,000 after a 15% tax rate?
```

**Response:** 
```
You will need to work 5.88 hours.
```

**Prompt:** 
```
Give me a summary for 40 base hours, 5 overtime hours at 1.5x, and 2 double time hours at 2.0x, with a $2 shift differential and 25% tax at $30 base rate.
```

**Response:** 
```
Gross Pay: $1,530.00, Tax: $382.50, Net Pay: $1,147.50, Effective Hourly Rate: $27.32.
```

## Capabilities

### Net Income Targeting
Your agent calculates the specific hours required to reach a set take-home pay amount.

### Tiered Overtime Math
The MCP processes multiple overtime rates like time-and-a-half or double time.

### Tax Integration
Your AI client applies tax rates to gross earnings to find actual net pay.

### Shift Differentials
The tool adds extra pay for specific shifts to the total earnings calculation.

### Payroll Summaries
Your agent generates a complete breakdown of a single pay period's earnings and taxes.

## Use Cases

### Goal-Based Planning
You tell your agent you need $500 for a bill, and it tells you how many hours to work to hit that net amount.

### Overtime Verification
You check your expected earnings against your employer's math to ensure accuracy.

### Budgeting
You use the payroll summary to see exactly how much cash you will have after taxes.

### Shift Differential Calculation
You calculate pay for night or weekend shifts that include extra hourly premiums.

## Benefits

- Eliminates manual math for tiered overtime and shift differentials.
- Provides net pay figures instead of just gross totals.
- Calculates required work hours based on specific financial goals.
- Handles complex payroll structures in a single request.

## How It Works

Connecting this MCP to your AI client gives you immediate access to payroll math tools.

1. Connect the MCP to your client like Claude or Cursor via Vinkius.
2. Provide your pay rates, hours, and tax details to your agent.
3. The agent uses the specific tool to run the math.
4. You receive a direct answer regarding your gross or net pay.

## Frequently Asked Questions

**Does this MCP account for taxes?**
Yes. It uses the tax rates you provide to calculate your final net take-home pay.

**Can I calculate double time pay?**
Yes. The tool handles multiple overtime tiers, including double time and shift differentials.

**How do I find out how many hours I need to work to make a certain amount?**
You can use the calculate_required_hours tool to find the exact hours needed to reach a specific net income goal.

**Which AI clients can use this MCP?**
You can use this with any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code.

**Do I need to host this myself?**
No. Vinkius hosts and manages the MCP for you. You just connect it to your client.

**How does the tool handle overtime?**
The tool uses `get_gross_pay` to apply specific multipliers for overtime and double time tiers based on the hours worked.

**Can I calculate how many hours I need to work to reach a specific goal?**
Yes, you can use `calculate_required_hours` to find the total hours needed to achieve your desired net take-home pay.

**Does it include shift differentials?**
Yes, the `get_payroll_summary` tool allows you to include a shift differential that is added to your hourly rates.
