# Appointment Capacity Calculator AI Agent Connect

> Appointment Capacity Calculator handles the math for your service business. It calculates how many clients you can actually see within specific time windows while accounting for mandatory buffer times and service durations. Your AI client uses these tools to prevent overbooking and optimize your daily or weekly schedule.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_mFkzSCPjD2U624Zrdy7xwioaZk82OXzl7bBbcgGU/ai-agent-connect
- **Tags:** scheduling, capacity-planning, time-management, service-providers, optimization

## Description

Managing a service-based business means constantly juggling time. You need to know exactly how many clients you can fit into a morning block without cutting into your lunch or skipping necessary prep time. This MCP takes that math off your plate. Instead of manually calculating gaps, you tell your AI client your available hours, the length of your appointments, and how much buffer you need between them. It handles the logic of overlapping slots and constraints. You can use it to test different service models or check if a last-minute request actually fits into your existing window. It's about knowing your limits before you commit to a booking.

## Tools

### calculate_max_capacity
This tool finds the total number of appointments that fit into a specific time block.

### check_slot_availability
Use this to see if your current window has enough room to add one more appointment.

### compare_service_plans
This tool compares two different service configurations to see which one maximizes your appointment count.

### calculate_capacity_with_constraints
This tool calculates how many appointments fit when you provide specific start and end times.

## Prompt Examples

**Prompt:** 
```
How many 30-minute appointments can I fit in a 4-hour window with a 5-minute buffer between each?
```

**Response:** 
```
You can fit 7 appointments in a 4-hour window with those constraints.
```

**Prompt:** 
```
I have a window from 09:00 to 12:00. How many 45-minute appointments can I schedule with a 10-minute buffer?
```

**Response:** 
```
You can schedule 4 appointments between 09:00 and 12:00.
```

**Prompt:** 
```
Is there enough time left for a 20-minute appointment if I have already used 100 minutes of a 150-minute window and need a 5-minute buffer?
```

**Response:** 
```
Yes, there is enough time remaining to accommodate the appointment.
```

## Capabilities

### Buffer Management
Your agent calculates the necessary downtime between sessions to prevent back-to-back burnout.

### Constraint Modeling
The AI uses specific start and end times to find realistic scheduling limits.

### Plan Comparison
Your agent compares different service lengths to see which yields more revenue or volume.

### Real-time Availability Checks
The AI checks if a new client request fits into your remaining time window.

## Use Cases

### Daily Planning
Calculate how many clients you can see between 9 AM and 5 PM with 15-minute breaks.

### Service Optimization
Compare a 30-minute service plan against a 45-minute plan to see the capacity difference.

### Last-minute Bookings
Check if a specific client request fits into a remaining time gap.

### Staffing Requirements
Determine how many staff members are needed based on total appointment capacity.

## Benefits

- Eliminates manual math for appointment buffers.
- Prevents overbooking by checking real-time slot availability.
- Compares service models to find the most efficient schedule.

## How It Works

Connect the MCP to your AI client and start asking about your schedule.

1. Connect the MCP to Claude, Cursor, or Windsurf via Vinkius.
2. Provide your appointment duration and required buffer time to your AI client.
3. Ask the agent to calculate capacity or check a specific time window.
4. Receive the exact number of available slots or confirmation of availability.

## Frequently Asked Questions

**How does this MCP handle buffer times?**
The tools include buffer time in the calculation to ensure you have the necessary gap between appointments.

**Can I use this with Claude?**
Yes, you can connect this MCP to any compatible client like Claude, Cursor, or Windsurf.

**What is the difference between the capacity tools?**
One tool finds the maximum possible slots, while another handles specific start and end time constraints.

**Does this help with comparing different service lengths?**
Yes, the compare_service_plans tool lets you see which configuration allows for more appointments.

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

**How does the tool handle buffer times?**
The tool treats the buffer as a required trailing component for every appointment slot to ensure operational readiness for the next possible slot.

**Can I compare two different service models?**
Yes, you can use `compare_service_plans` to determine which configuration of duration and buffer allows for more appointments within the same window.

**What happens if the appointment is longer than the available time?**
The tool will return an error if the requested appointment duration exceeds the total available window.