# Service Utilization is your resource monitor. AI Agent Connect

> Service Utilization gives your AI client direct access to your resource data. It calculates how much of your team's time is actually booked versus available, allowing you to monitor current efficiency and forecast future capacity. Instead of manually checking spreadsheets, you just ask your agent for the numbers.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_Mv7SkJIhawoVKKEjDuets8GEMuBDJBn6KApoMHMx/ai-agent-connect
- **Tags:** utilization, capacity, scheduling, efficiency, workforce

## Description

You can stop digging through scheduling software to find out who is busy and who is idle. This MCP connects your AI client to your resource management data so you can get instant answers about workload. You can check the specific utilization percentage for a single person or look at the aggregate efficiency of an entire department. If you need to plan ahead, your agent can compare existing bookings against theoretical capacity to give you a realistic forecast of future availability. It also provides daily breakdowns of booked versus available hours, making it easy to spot gaps in a schedule or identify when a team is hitting a breaking point. It turns your agent into a capacity planning specialist that knows exactly how much room you have left to work.

## Tools

### get_resource_availability_schedule
This tool retrieves a daily breakdown of available versus booked hours within a specific date range.

### get_resource_capacity_forecast
This tool estimates future availability by comparing current bookings against theoretical capacity. It helps you predict if you'll have enough hands on deck later.

### get_resource_utilization
This tool calculates the utilization percentage for a specific resource over a set timeframe. It tells you exactly how much of a person's time is occupied.

### get_team_utilization
This tool provides the aggregate utilization for a group of resources. Use it to see if a whole team is overextended or underutilized.

## Prompt Examples

**Prompt:** 
```
What is the utilization for resource 'res-123' from 2024-01-01 to 2024-01-07?
```

**Response:** 
```
The utilization rate for resource 'res-123' is 85%, with 34 booked hours out of 40 available hours.
```

**Prompt:** 
```
Is the team [res-01, res-02] overloaded this week?
```

**Response:** 
```
The aggregate utilization for the team is 105%, with 84 total booked hours and 80 total available hours, indicating they are currently overloaded.
```

**Prompt:** 
```
How much capacity will resource 'res-456' have on 2024-12-25?
```

**Response:** 
```
On 2024-12-25, resource 'res-456' is expected to have 8 remaining capacity hours with an expected utilization of 20%.
```

## Capabilities

### Individual Tracking
Your agent checks the specific utilization percentage for any single resource.

### Team Aggregation
Your agent calculates the combined efficiency of a group of people.

### Capacity Forecasting
Your agent compares bookings against capacity to predict future availability.

### Daily Scheduling
Your agent pulls daily breakdowns of booked and available hours.

## Use Cases

### Staffing Forecasts
Ask your agent to predict if a team will have enough capacity for a project starting next month.

### Workload Audits
Check the utilization of specific employees to see who has been overbooked lately.

### Daily Planning
Get a quick breakdown of available hours for the week to assign new tasks.

### Team Health Checks
Use aggregate utilization to see if a department is consistently operating above 100% capacity.

## Benefits

- Calculates utilization percentages without manual math.
- Predicts future capacity by comparing bookings to theoretical limits.
- Identifies team overloads through aggregate utilization data.
- Provides daily availability breakdowns for precise scheduling.

## How It Works

Getting this running takes seconds because Vinkius handles the hosting and management.

1. Subscribe to the Service Utilization MCP on Vinkius.
2. Connect your AI client like Claude or Cursor using the provided link.
3. Ask your agent a question about resource utilization or capacity.
4. The agent uses the MCP tools to pull the data and give you a direct answer.

## Frequently Asked Questions

**How does this MCP calculate utilization?**
It calculates the percentage of a resource's available hours that are currently booked.

**Can I check the capacity of a whole team at once?**
Yes, the get_team_utilization tool provides the aggregate utilization for any group of resources you specify.

**Does this help with future planning?**
Yes, the get_resource_capacity_forecast tool estimates future availability by comparing current bookings against theoretical capacity.

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

**Do I need to host this myself?**
No, Vinkius hosts the MCP and manages all the technical requirements so it is ready to use immediately.

**How is the utilization rate calculated?**
The utilization rate is the ratio of booked hours to available hours. If booked hours exceed available hours, the rate will exceed 100% and the resource is marked as overloaded.

**Can I check the utilization for an entire team?**
Yes, you can use `get_team_utilization` by providing a list of resource IDs to get the aggregate metrics for the group.

**How do I forecast future capacity?**
Use the `get_resource_capacity_forecast` tool to estimate remaining capacity and expected utilization for a specific future date.