# Weekly Routine Builder AI Agent Connect

> Weekly Routine Builder MCP manages the friction between your fixed work obligations and your physiological needs. It calculates your actual free time after sleep and work, then slots in meals, exercise, and high-priority tasks. You can check if your schedule is actually sustainable or find out exactly why a specific task won't fit into your week.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_r5nLqtRskdN7taJ2BSPRXx8CucaCByt9mJV3rNku/ai-agent-connect
- **Tags:** routine, planner, scheduling, wellness, time-management

## Description

Most schedules fail because they ignore how your body actually works. You plan a busy work week and then wonder why you're exhausted or why you can't find time to hit the gym. This MCP changes that by treating sleep, nutrition, and movement as non-negotiable constraints rather than afterthoughts. 

You give your AI client your fixed work hours and sleep requirements. The MCP calculates your remaining capacity and attempts to build a tentative routine that fits your priorities into the gaps. It doesn't just guess; it checks your plan against health standards to ensure you aren't overextending yourself. If you try to add a task that won't work, the MCP identifies the specific conflict so you can adjust your plan instead of just staring at a broken calendar. It's about building a week you can actually live through.

## Tools

### validate_routine_health
This tool checks your generated schedule against physiological and logical health standards. It flags if your routine is missing key elements like enough sleep or movement.

### build_tentative_routine
This tool attempts to place your meals, exercise, and personal priorities into the available gaps in your schedule. It works around your existing fixed obligations.

### get_available_capacity
This tool calculates how much free time you actually have left in a week. It subtracts your fixed work hours and sleep requirements from the total time available.

### identify_schedule_conflicts
This tool pinpoints the exact reason why a specific task cannot be added to your schedule. It helps you diagnose overlaps or insufficient time blocks.

## Prompt Examples

**Prompt:** 
```
I have 168 hours total. I need 8 hours of sleep per night. I work Monday to Friday from 9 AM to 5 PM. Can you build a routine for me?
```

**Response:** 
```
I have calculated your capacity and generated a routine. Your schedule includes 8 hours of sleep nightly, your work blocks, and has successfully integrated meal times and exercise sessions into your remaining free time.
```

**Prompt:** 
```
Why can't I fit my gym session into my current schedule?
```

**Response:** 
```
The conflict is due to an overlap between your scheduled gym session and your fixed work obligation from 9 AM to 5 PM.
```

**Prompt:** 
```
Is my current weekly schedule balanced?
```

**Response:** 
```
Your routine has a health score of 85. It is well-balanced, though there is a warning that your movement frequency is slightly lower than recommended.
```

## Capabilities

### Capacity Calculation
Your agent uses this to determine how much time is left after accounting for sleep and work.

### Automated Scheduling
The AI uses this to slot meals and exercise into your open time blocks.

### Health Validation
Your agent runs this to check if your routine meets physiological standards.

### Conflict Diagnosis
The AI uses this to find out why a specific task won't fit into your week.

## Use Cases

### Managing Work-Life Balance
You provide your 9 to 5 work hours and let the AI find time for your gym sessions and meal prep.

### Routine Troubleshooting
When a task won't fit, you ask the AI to find the conflict so you can move other obligations.

### Health Auditing
You check an existing schedule to see if you are getting enough sleep or movement.

### Capacity Planning
You determine exactly how many hours you have for personal projects after your fixed commitments are set.

## Benefits

- Calculates real free time by subtracting sleep and work from your total weekly hours.
- Identifies specific scheduling overlaps that prevent you from completing tasks.
- Provides a health score to check if your routine is physically sustainable.
- Automates the placement of meals and exercise into your available gaps.

## How It Works

Setting up a balanced routine is a direct process from data input to a validated schedule.

1. Connect your preferred MCP-compatible client to Vinkius.
2. Provide your fixed obligations like work hours and sleep requirements to your AI client.
3. The AI uses the MCP to calculate your available capacity and build a tentative routine.
4. The AI validates the routine against health standards to ensure it is sustainable.
5. Review the final schedule or use conflict diagnosis to fix any issues.

## Frequently Asked Questions

**How does this MCP calculate my free time?**
It uses the get_available_capacity tool to subtract your fixed work hours and required sleep from the total hours in a week.

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

**What happens if my schedule is too crowded?**
The identify_schedule_conflicts tool will pinpoint exactly why a task cannot be accommodated, such as an overlap with a work block.

**How do I know if my routine is healthy?**
The validate_routine_health tool checks your schedule against physiological and logical health standards to provide a health score.

**Does this MCP host my data?**
Vinkius hosts and manages the MCP, so it is ready to use immediately once you connect your client.

**How does the engine handle conflicting tasks?**
The engine uses `identify_schedule_conflicts` to pinpoint whether a failure is due to an overlap with fixed obligations, insufficient total time, or a priority failure.

**Can I check if my routine is healthy?**
Yes, the `validate_routine_health` tool evaluates your schedule against physiological standards, providing a health score and warnings about meal gaps or movement frequency.

**What information is needed to start building a routine?**
You need to provide your total available weekly hours, your sleep target, a list of fixed obligations, and your requirements for meals, movement, and priority tasks.