# Benefit Total Calculator AI Agent Connect

> Benefit Total Calculator MCP lets your AI client aggregate base salaries and various benefit categories into a single economic value. You can quickly find where your company spends the most on supplemental benefits or check if your compensation data is formatted correctly before running reports.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_mN99XBECQHAn9oRuBa0NwwLIdqVTBSKXt2rRF4Kx/ai-agent-connect
- **Tags:** compensation, benefits, hr, payroll, analytics

## Description

Calculating the true cost of an employee involves more than just looking at a base salary. You have to account for health insurance, retirement contributions, wellness stipends, and other perks. This MCP gives your agent the ability to sum these disparate numbers into a single, accurate total reward figure. Instead of manually building spreadsheets to compare packages, you can ask your AI client to run the math for you. You can use it to spot which benefit categories are eating up the most budget or to verify that your compensation data follows the right structure. It turns raw payroll and benefits data into actionable insights without the manual arithmetic.

## Tools

### calculate_total_compensation
This tool computes the full monetary value of an employee's entire package. It combines base pay with all supplemental benefits provided.

### find_highest_benefit_category
This tool identifies which specific benefit category has the largest cumulative cost. It's useful for spotting your biggest supplemental spend areas.

### get_category_totals
This tool sums up the total amount spent on each specific benefit type. It helps you see exactly how much is going toward health, retirement, or other categories.

### validate_benefit_structure
This tool checks if your set of benefit values is formatted correctly. It ensures your data is clean before you perform calculations.

## Prompt Examples

**Prompt:** 
```
What is the total compensation for an employee with a 100000 base salary and benefits: health 5000 and retirement 2000?
```

**Response:** 
```
The total compensation is 107000.
```

**Prompt:** 
```
Show me the total spent on each benefit category for: health 5000, health 2000, and wellness 1000.
```

**Response:** 
```
The totals are: health 7000 and wellness 1000.
```

**Prompt:** 
```
Which benefit category is the largest for: insurance 3000, travel 5000, and gym 1000?
```

**Response:** 
```
The largest benefit category is travel.
```

## Capabilities

### Total Reward Calculation
Your agent uses this to combine base pay and benefits into one number.

### Spending Analysis
The AI uses this to group and sum costs by benefit type.

### Data Integrity Checks
Your agent uses this to confirm benefit values are formatted properly.

### Budget Outlier Detection
The AI uses this to find the single largest benefit category in a dataset.

## Use Cases

### Offer Letter Preparation
Calculate the full economic value of a job offer to present a complete package to a candidate.

### Budget Auditing
Check how much the company is spending on specific categories like wellness or insurance.

### Data Cleaning
Verify that your benefit data is structured correctly before running large-scale payroll reports.

### Benefit Optimization
Find out which supplemental benefits are the most costly to help inform future policy changes.

## Benefits

- Combines base salary and benefits into a single total reward figure.
- Groups spending by category to show where budget is allocated.
- Validates data formatting to prevent calculation errors.
- Identifies the most expensive benefit categories automatically.

## How It Works

Connecting this MCP to your AI client gives your agent immediate access to compensation math tools.

1. Connect your preferred AI client to Vinkius.
2. Select the Benefit Total Calculator MCP from the catalog.
3. Provide your compensation or benefit data to your agent.
4. Ask your agent to calculate totals, find highest spends, or validate data.

## Frequently Asked Questions

**How do I use this MCP with Claude?**
You connect your Claude client to Vinkius, which hosts the MCP. Once connected, you can simply ask Claude to perform compensation calculations using the available tools.

**What kind of data does this MCP handle?**
It handles base salary figures and various benefit category values like health, retirement, and wellness.

**Can this MCP help with data errors?**
Yes, you can use the validate_benefit_structure tool to check if your benefit values are formatted correctly.

**Does this MCP work with Cursor or Windsurf?**
Yes, any MCP-compatible client like Cursor or Windsurf can use these tools once connected via Vinkius.

**Can I see how much I spend on insurance specifically?**
Yes, you can use the get_category_totals tool to see the total amount spent on any specific benefit type.

**How do I calculate the total compensation?**
You can use the `calculate_total_compensation` tool by providing the annual base salary and a list of benefit objects.

**Can I check if my benefit data is valid?**
Yes, use the `validate_benefit_structure` tool to ensure your benefit objects contain the required category and amount fields.

**How can I see which benefit is the most expensive?**
The `find_highest_benefit_category` tool will identify which category has the highest cumulative sum.