# Referee Fee Calculator AI Agent Connect

> Referee Fee Calculator MCP handles the math behind official compensation. It manages regional base rates, tiered pay structures based on match volume, and total payouts including performance bonuses. Your AI client uses these tools to turn match counts into accurate financial data.

## Overview
- **Category:** finance
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_4uTbqa69lr5UFCmzoYimsicN79RPwXTFstORpdIT/ai-agent-connect
- **Tags:** referee, compensation, fees, sports-management, calculation

## Description

Managing payouts for sports officials shouldn't involve manual spreadsheets or constant math errors. This MCP gives your AI client the specific logic needed to handle referee compensation across different regions and experience levels. You can use it to pull standard regional fees or calculate exactly what an official is owed after a certain number of matches. It accounts for tiered pay structures where rates change as officials hit higher match volumes. If you need to calculate final payouts that include volume-based bonuses, the MCP handles those calculations directly. It's a precise way to bridge the gap between match logs and actual payments.

## Tools

### calculate_match_total
This tool computes the total fee for a specific number of matches.

### calculate_volume_bonus_total
This tool calculates the final payment amount by factoring in volume-based tier increases.

### get_base_fee
Use this to pull the standard fee and specific currency for a given region.

### get_tiered_fee_rate
This tool identifies the correct fee rate based on how many matches an official has completed.

## Prompt Examples

**Prompt:** 
```
What is the standard fee for a match in the USA?
```

**Response:** 
```
The standard fee for a match in the USA is 50 USD.
```

**Prompt:** 
```
How much is the total pay for 10 matches at 40 per match?
```

**Response:** 
```
The total pay for 10 matches at 40 per match is 400.
```

**Prompt:** 
```
What tier is an official in after 50 matches?
```

**Response:** 
```
An official with 50 matches has reached the Professional Tier.
```

## Capabilities

### Regional Rate Lookup
Your agent pulls the correct base fee and currency for any specific region.

### Tiered Rate Calculation
The AI determines the appropriate pay rate based on an official's match history.

### Volume Bonus Processing
Your client calculates total payouts that include bonuses for high-volume officials.

### Total Match Payouts
The AI computes the sum of fees for a set number of matches instantly.

## Use Cases

### End of Season Payouts
Calculate the total compensation for all officials including their volume bonuses.

### Regional Budgeting
Determine expected costs by looking up base fees for specific regions.

### Tier Verification
Check which pay tier an official qualifies for based on their current match count.

### Quick Fee Quotes
Get immediate answers on standard match rates for new officials.

## Benefits

- Eliminates manual calculation errors in tiered pay structures.
- Standardizes fee lookups across different geographic regions.
- Automates the application of volume-based bonuses.
- Provides instant totals for match sets.

## How It Works

Connect your AI client to the Vinkius-hosted MCP to start running calculations.

1. Connect your preferred MCP-compatible client to Vinkius.
2. Provide the AI with match counts or regional data.
3. The AI invokes the necessary tools to fetch rates or calculate totals.
4. Your agent delivers the final compensation figures or tier status.

## Frequently Asked Questions

**How does the MCP handle different currencies?**
The get_base_fee tool retrieves both the standard fee and the specific currency used in a given region.

**Can this calculate bonuses for high-volume officials?**
Yes, the calculate_volume_bonus_total tool specifically handles payments that include volume-based tier increases.

**Does it support tiered pay structures?**
Yes, the get_tiered_fee_rate tool determines the applicable rate based on the number of matches completed.

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

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

**How do I find the standard fee for a specific region?**
You can use the `get_base_fee` tool and provide the region name, such as 'USA' or 'Europe'.

**Can I calculate total pay including volume bonuses?**
Yes, use the `calculate_volume_bonus_total` tool to get the final payout considering tiered increases.

**What happens if I provide an invalid region?**
The `get_base_fee` tool will return an error if the requested region is not supported in the regional standards catalog.
