# Roommate Chore Rotation AI Agent Connect

> Roommate Chore Rotation MCP uses effort points and individual weights to distribute household tasks fairly. It calculates workloads, builds weekly schedules, and audits them to ensure no one is stuck doing all the heavy lifting. You can connect it to your AI client once and let your agent handle the household logistics.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_RqfaHdVrEMa08dojy2hKxxK3JvTSmcDXBqS2oJTy/ai-agent-connect
- **Tags:** chores, roommates, scheduling, fairness, automation

## Description

Managing a shared house shouldn't feel like a second job. This MCP takes the guesswork out of cleaning and maintenance by treating chores like a math problem rather than a source of conflict. You assign effort points to tasks based on how much work they actually take, and set weights for each roommate to account for different availability or capacities. 

Your AI client uses these numbers to build a schedule where the total effort is balanced across the house. It doesn't just dump tasks on people; it checks for gaps and validates that the final plan actually follows the rules you set. If a task can't be assigned because of a constraint, the MCP flags it immediately. It's a way to turn messy roommate discussions into a clear, data-driven plan that everyone can agree on.

## Tools

### calculate_effort_distribution
This tool finds the specific target effort each person should handle to keep things balanced. It uses your roommate weights to set these goals.

### find_uncovered_tasks
This tool identifies any chores that couldn't be assigned due to your specific constraints. It shows you exactly what's missing from the plan.

### generate_weekly_schedule
This tool builds a complete, optimized schedule for a seven-day period. It maps out every task based on your effort and weight settings.

### validate_schedule_fairness
This tool audits your current schedule against your effort-balancing logic. It checks if the distribution is actually fair according to your rules.

## Prompt Examples

**Prompt:** 
```
Generate a weekly chore schedule for my roommates.
```

**Response:** 
```
Here is the optimized weekly schedule: Monday: Dishes (Alice, 2pts), Tuesday: Vacuuming (Bob, 3pts), Wednesday: Trash (Alice, 1pt).
```

**Prompt:** 
```
How much effort should each roommate handle?
```

**Response:** 
```
Based on the provided weights, the target effort distribution is: Alice: 15pts, Bob: 10pts, Charlie: 15pts.
```

**Prompt:** 
```
Check if the current schedule is fair.
```

**Response:** 
```
The schedule is fair. The deviation from target effort for all roommates is within the acceptable range.
```

## Capabilities

### Effort-based balancing
Your agent uses effort points to ensure hard tasks weigh more than easy ones.

### Capacity adjustment
The MCP applies roommate weights to account for different schedules or abilities.

### Gap detection
Your AI client identifies tasks that were left out of the rotation.

### Fairness auditing
The agent verifies that the final schedule matches your mathematical fairness goals.

## Use Cases

### Weekly chore planning
Create a new rotation every Sunday night to keep the house clean.

### Resolving workload disputes
Use the fairness audit to prove a schedule is balanced if someone complains.

### Adjusting for busy weeks
Update roommate weights when someone has a heavy work or school schedule.

### Task gap analysis
Find out which chores are being missed when constraints make scheduling difficult.

## Benefits

- Reduces household arguments by using math instead of opinions.
- Accounts for individual availability through roommate weighting.
- Identifies scheduling gaps before they become problems.
- Provides a verifiable audit of how work is distributed.

## How It Works

Connect the MCP to your AI client and start delegating household management.

1. Connect the MCP to your preferred client like Claude or Cursor.
2. Provide your list of chores and their effort points.
3. Set the weights for each roommate in your house.
4. Ask your agent to generate or validate the schedule.

## Frequently Asked Questions

**How does the MCP decide who does which chore?**
It uses effort points for each task and roommate weights to balance the workload. This ensures the total effort is distributed according to the capacity you set for each person.

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

**What happens if a chore can't be assigned?**
The MCP includes a tool to find uncovered tasks. It will tell you exactly which chores couldn't be fit into the schedule based on your constraints.

**How do I make the schedule fairer?**
You can adjust the roommate weights or the effort points assigned to specific tasks. You can also use the validation tool to check if your current plan meets your fairness criteria.

**Do I need to host this myself?**
No, Vinkius hosts and manages the MCP for you. You just connect your client and start using the tools.

**How is fairness determined?**
Fairness is achieved by balancing the ratio of actual effort points assigned to a person against their specific roommate weight.

**Can I handle tasks I am excluded from?**
No, the system respects exclusion constraints to ensure no roommate is assigned a task they are barred from performing.

**What happens if a task cannot be assigned?**
If a task cannot be assigned due to availability or exclusion constraints, you can use `find_uncovered_tasks` to identify it.
