# Photo Session Timekeeper is your production scheduler. AI Agent Connect

> Photo Session Timekeeper helps photography production managers build accurate schedules. It handles the math for shot durations, setup times, and breaks, ensuring your shoot plan actually fits within your booked window. You can use it to check subject workloads or find the best time for a break without manual calculation.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_J6ozvz0p7mVGqftzOlAD4pBi6kTVMqasbalggSqD/ai-agent-connect
- **Tags:** photography, timeline, production, scheduling, management

## Description

Managing a photo shoot is a constant battle against the clock. You have models, lighting setups, and specific shot requirements that all need to fit into a rigid window. This MCP takes your raw list of shots, setup requirements, and break needs to build a chronological schedule. Instead of guessing if you have enough time, you can verify your capacity instantly. It identifies which subjects are being overbooked and helps you find the right moments to pause. It's built to handle the heavy lifting of production math so you can focus on the creative side of the shoot.

## Tools

### find_earliest_break_slot
This tool identifies the first available window for a break based on your current schedule. It looks at the sequence of shots and setups to find the most logical pause.

### calculate_session_timeline
This tool builds a full chronological list of every event in your shoot. It also calculates how much unscheduled time is left in your window.

### get_subject_load_analysis
This tool calculates the total time allocated to each specific subject. It helps you see if one model or setup is hogging too much of the production time.

### validate_session_capacity
This tool checks if your proposed shots and breaks will actually fit in the time you have. It prevents you from overbooking a session before you even start.

## Prompt Examples

**Prompt:** 
```
Generate a timeline for a shoot starting at 2024-10-01T09:00:00Z and ending at 2024-10-01T12:00:00Z. Subjects are 'Model A' and 'Model B'. Shot durations are 30 and 45 minutes. Setup times are 10 and 15 minutes. There is one 20-minute break.
```

**Response:** 
```
The session timeline is as follows: 09:00 - 09:10 Setup for Model A, 09:10 - 09:40 Shot of Model A, 09:40 - 10:00 Break, 10:00 - 10:15 Setup for Model B, 10:15 - 11:00 Shot of Model B. Total unscheduled time remaining: 60 minutes.
```

**Prompt:** 
```
Check if I can fit two 60-minute shots with 15-minute setups and a 30-minute break between 10:00 AM and 12:00 PM.
```

**Response:** 
```
The plan is not feasible. The total required time is 180 minutes, but the session window is only 120 minutes.
```

**Prompt:** 
```
Analyze the workload for subjects: 'Portrait 1' (45m shot, 10m setup) and 'Portrait 2' (30m shot, 20m setup).
```

**Response:** 
```
Portrait 1 has a total load of 55 minutes, and Portrait 2 has a total load of 50 minutes.
```

## Capabilities

### Timeline Generation
Your agent creates a minute-by-minute schedule of setups, shots, and breaks.

### Capacity Validation
Your agent checks if your shot list fits within your booked time window.

### Workload Analysis
Your agent calculates the total time assigned to each subject to prevent overbooking.

### Break Optimization
Your agent finds the earliest possible time to insert a break into the schedule.

## Use Cases

### Pre-Production Planning
Build a complete timeline for a multi-model shoot before arriving on set.

### Client Feasibility Checks
Instantly see if a client's requested shot list is physically possible within their budget.

### On-Set Adjustments
Recalculate the remaining timeline if a setup takes longer than expected.

### Resource Management
Check the total time load for each subject to ensure a fair and efficient workflow.

## Benefits

- Eliminates manual math for calculating setup and shot durations.
- Prevents overbooked sessions by validating capacity before the shoot starts.
- Identifies heavy workloads for specific subjects or models.
- Provides a clear chronological list of events for the crew.

## How It Works

Connect your AI client to Vinkius to start managing your production math.

1. Connect your MCP-compatible client to Vinkius.
2. Provide your shot list, setup times, and total window to your agent.
3. The agent uses the MCP tools to calculate the timeline or validate capacity.
4. Review the generated schedule or workload analysis in your chat interface.

## Frequently Asked Questions

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

**How does the MCP handle setup times?**
The MCP treats setup times as distinct events that must be accounted for alongside shot durations to create an accurate timeline.

**Can I check if my shoot is overbooked?**
Yes, you can use the validation tool to see if your proposed shots and breaks fit within your available time.

**Does this MCP manage my actual calendar?**
No, this MCP is a calculation and scheduling tool that helps you build the plan to use in your own management systems.

**How do I find the best time for a break?**
You can use the tool designed to find the earliest break slot based on your current sequence of events.

**How do I know if my shoot plan is feasible?**
You can use the `validate_session_capacity` tool to check if your proposed shots, setups, and breaks fit within your specified start and end times.

**Can I see how much time is allocated to each subject?**
Yes, the `get_subject_load_analysis` tool provides a breakdown of the total time footprint (setup plus shot duration) for every subject.

**What happens to the extra time in a session?**
Any remaining time after all scheduled shots, setups, and breaks is identified as unscheduled duration by the `calculate_session_timeline` tool.
