# Performance Bonus Calculator AI Agent Connect

> Performance Bonus Calculator MCP handles the math behind professional incentive payouts. Your AI client uses this to calculate gross earnings, apply tax withholdings, and verify that performance scores stay within company limits. It turns complex payroll formulas into direct answers for your bonus planning and employee compensation queries.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_j7u3lGTBaaxEnJF9VTTAYiqeRK2aqPej4RLkPgQt/ai-agent-connect
- **Tags:** bonus, salary, tax, performance, payroll

## Description

You can stop manually running bonus formulas in spreadsheets. This MCP gives your AI client the specific logic needed to handle professional incentive payouts from start to finish. You can use it to figure out what an employee earned before taxes, what they actually take home, or a full breakdown of the entire payout lifecycle. It also includes a way to check if achievement scores and multipliers align with your corporate rules before you finalize any numbers. Whether you are modeling different compensation scenarios or verifying a specific payout, your agent handles the heavy lifting of the math and tax logic.

## Tools

### calculate_gross_bonus
This tool determines the total bonus amount earned before any tax deductions are applied.

### calculate_net_bonus
This tool calculates the actual amount an employee receives after tax withholdings.

### get_bonus_summary
This tool provides a full breakdown of the bonus lifecycle, covering everything from base salary to the final net payout.

### validate_performance_metrics
This tool verifies that achievement and multiplier values stay within your specific corporate bounds.

## Prompt Examples

**Prompt:** 
```
Calculate the gross bonus for a salary of 100,000 with a 10% target and 1.2 achievement score.
```

**Response:** 
```
The gross bonus is 12,000.
```

**Prompt:** 
```
What is the net bonus for a 5,000 gross bonus with a 20% tax rate?
```

**Response:** 
```
The net bonus is 4,000 and the tax amount is 1,000.
```

**Prompt:** 
```
Give me a summary for a 120,000 salary, 15% target, 1.0 achievement, and 25% tax rate.
```

**Response:** 
```
The gross bonus is 18,000, the tax amount is 4,500, and the net bonus is 13,500.
```

## Capabilities

### Gross Payout Calculation
Your agent calculates total earnings based on salary, targets, and achievement scores.

### Net Income Estimation
The AI determines the final take-home pay after applying tax rates.

### Metric Validation
Your agent checks if performance multipliers are within allowed company ranges.

### Full Payout Summaries
The AI generates a complete view of the bonus from base salary to net amount.

## Use Cases

### Compensation Modeling
Test how different achievement scores impact total company bonus spend.

### Employee Inquiries
Get quick, accurate answers for staff asking about their net bonus amounts.

### Compliance Checking
Ensure all proposed performance multipliers fall within approved corporate limits.

### Payroll Auditing
Verify that gross to net calculations match expected tax withholding patterns.

## Benefits

- Eliminates manual math errors in bonus calculations.
- Standardizes how achievement scores are validated against company rules.
- Provides instant tax withholding estimates for net pay transparency.
- Consolidates the entire bonus lifecycle into a single summary.

## How It Works

Connect your client to Vinkius and start running calculations immediately.

1. Connect your AI client to the Vinkius hosted MCP.
2. Provide your agent with salary, target, and achievement data.
3. The agent calls the specific tool needed for gross, net, or summary data.
4. Your agent returns the calculated results or validation status.

## Frequently Asked Questions

**How do I use this MCP with my AI client?**
You connect your client, such as Claude or Cursor, to Vinkius. Once connected, your agent can immediately call the bonus calculation tools.

**Can this MCP handle tax withholdings?**
Yes. The calculate_net_bonus tool specifically calculates the final amount after tax deductions are applied.

**Does it check if performance scores are valid?**
Yes. The validate_performance_metrics tool checks if achievement and multiplier values are within your corporate bounds.

**What kind of summary can I get?**
The get_bonus_summary tool provides a full breakdown from the initial base salary through to the final net payout.

**Do I need to host this myself?**
No. Vinkius hosts and manages the MCP, so it is ready to use as soon as you connect your client.

**How do I calculate the final amount an employee receives?**
You can use `calculate_net_bonus` to find the final amount after taxes, or use `get_bonus_summary` to see the full breakdown from base salary to net payout.

**Can I apply a maximum limit to the bonus?**
Yes, the `calculate_gross_bonus` tool allows you to specify a `bonusCap` to ensure the payout does not exceed a certain threshold.

**How are achievement scores handled?**
The achievement score scales the target bonus. You can use `validate_performance_metrics` to verify if a score is within the acceptable corporate range.