# Room Sharing Arrangement Engine AI Agent Connect

> Room Sharing Arrangement Engine MCP manages how people are assigned to living spaces. It uses a logic engine to balance physical accessibility needs, privacy requirements, and social compatibility. Your AI client can run these calculations to find the best room distributions based on your specific household rules.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_k13EbHbsOxlPgyG2GJ4dEPv9tcp6d6uIxD3pHS2x/ai-agent-connect
- **Tags:** optimization, accommodation, logic-engine, room-assignment, constraints

## Description

You can stop manually juggling roommate preferences and physical requirements. This MCP acts as a logic engine for household occupancy. It processes complex constraints that usually make manual planning a headache, like ensuring a person with mobility issues gets an accessible room or making sure certain roommates aren't placed together. You give your agent the list of people, the available rooms, and the social or physical rules, and it handles the math. It checks if assignments are valid, verifies that social rules don't contradict each other, and gives you a clear view of how your space is being used. Whether you are managing a dorm, a large shared house, or a care facility, this tool keeps the assignments logical and consistent.

## Tools

### get_occupancy_summary
This tool provides a high level overview of how people are currently distributed across rooms.

### check_room_availability
Use this to see if a specific person can actually fit into a specific room based on current constraints.

### find_room_assignments
This tool generates the primary list of room allocations for all people in the household.

### validate_compatibility_matrix
This tool checks your social rules to make sure they are logically consistent and don't conflict.

## Prompt Examples

**Prompt:** 
```
Generate room assignments for 3 members and 2 rooms.
```

**Response:** 
```
The assignments are: Member 1 to Room A, Member 2 to Room A, and Member 3 to Room B. There is 1 unused bed remaining.
```

**Prompt:** 
```
Is Room 101 available for John given the current occupants?
```

**Response:** 
```
No, John cannot be assigned to Room 101 due to insufficient accessibility features.
```

**Prompt:** 
```
Show me a summary of the current room occupancy.
```

**Response:** 
```
Room A has 2 occupants and 0 remaining capacity. Room B has 1 occupant and 1 remaining capacity.
```

## Capabilities

### Constraint-Based Allocation
Your agent uses this to assign people to rooms while respecting physical and social rules.

### Accessibility Verification
The AI checks if a room meets the specific physical needs of a person.

### Social Rule Validation
Your agent runs this to ensure roommate compatibility rules don't create logical deadlocks.

### Occupancy Tracking
The AI uses this to report on how much space is left in each room.

## Use Cases

### Student Housing
Assign roommates based on social compatibility and shared study habits.

### Assisted Living
Match residents to rooms that meet their specific physical accessibility requirements.

### Large Shared Households
Organize room distributions for groups of people living in a single large property.

### Conflict Resolution
Use the compatibility matrix to verify that new roommate requests don't violate existing house rules.

## Benefits

- Automates the math behind complex roommate compatibility.
- Prevents assignment errors by checking accessibility needs against room features.
- Identifies logical conflicts in social rules before they become real world problems.
- Provides instant visibility into room capacity and occupancy status.

## How It Works

Setting up the logic engine is a direct process from connection to assignment.

1. Connect the MCP to your preferred AI client through Vinkius.
2. Provide your list of people, rooms, and specific constraints to your agent.
3. Ask the agent to run the assignment or validation tools.
4. Review the generated room distributions or occupancy summaries.

## Frequently Asked Questions

**How does this MCP handle accessibility needs?**
The logic engine includes accessibility as a core constraint. It checks if a person's specific needs match the features of a room before making an assignment.

**Can I use this with Claude or Cursor?**
Yes. Since this is an MCP, it works with any MCP-compatible client like Claude, Cursor, or Windsurf.

**What happens if my social rules are contradictory?**
You can use the validation tool to check your compatibility matrix. It will identify if your social rules are logically inconsistent.

**Does Vinkius host the logic engine?**
Yes. Vinkius hosts the MCP and manages the execution, so you don't have to run any local code.

**Can it tell me how many beds are left?**
Yes. The occupancy summary tool provides details on current occupants and remaining capacity in each room.

**How does the engine handle accessibility needs?**
The engine ensures that members with specific physical requirements are only assigned to rooms that possess the necessary accessibility features.

**Can I check if a specific room is suitable for a person?**
Yes, you can use the `check_room_availability` tool to evaluate if a member can legally enter a room based on capacity, accessibility, and existing occupants.

**What happens if compatibility rules conflict?**
You can use `validate_compatibility_matrix` to detect logical paradoxes, such as when one rule requires two people to share while another forbids it.