# Sleep Satisfaction Scorer AI Agent Connect

> Sleep Satisfaction Scorer turns your qualitative sleep notes and questionnaire ratings into hard numbers. It calculates a holistic satisfaction score, identifies what actually helped or hurt your rest, and measures the psychological impact of missing your sleep goals. Your AI client uses these metrics to pinpoint exactly where you can improve.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_qv0uN4u7ayu8MwIR7UqfUBDPJA9TdlBrp87Dewd8/ai-agent-connect
- **Tags:** sleep, health-tech, wellness, scoring, analytics

## Description

You can't fix what you don't measure. This MCP takes your subjective feelings about sleep—how deep you felt you slept, how continuous it was, and how much you actually rested—and converts them into a structured satisfaction score. Instead of just saying you feel tired, you can use this to see how much your actual sleep duration deviated from your target and how that gap affects your mental state. It breaks down the specific drivers and inhibitors of your rest, so you aren't just guessing why you woke up feeling groggy. By connecting this to your AI client, you turn a simple diary or a set of ratings into a data-driven feedback loop for your health.

## Tools

### analyze_expectation_gap
This tool quantifies the psychological impact of missing your sleep goals. It measures how much the difference between your target sleep and actual sleep affects your overall feeling.

### calculate_satisfaction_score
This tool generates a single holistic score for a sleep session. It uses your ratings for quality, depth, and continuity to give you a baseline number.

### identify_influencing_factors
This tool finds the specific drivers and inhibitors of your rest. It tells you which parts of your sleep contributed most to how you feel.

### suggest_improvement_areas
This tool provides specific categories for improvement. It gives you actionable directions based on your sleep data.

## Prompt Examples

**Prompt:** 
```
Calculate my sleep satisfaction score. I rated quality as 8, depth as 7, and continuity as 9. I expected 8 hours but slept 7 hours.
```

**Response:** 
```
Your satisfaction score is 7.5. You had a 1-hour expectation gap, which lowered your score despite high continuity.
```

**Prompt:** 
```
What were the main factors affecting my sleep? My ratings were quality: 4, depth: 5, continuity: 8, and my satisfaction score was 5.
```

**Response:** 
```
The primary inhibitors for your sleep were low quality and depth ratings, while high continuity was a positive driver.
```

**Prompt:** 
```
I slept 6 hours but wanted 8. My quality was 7, depth 6, and continuity 7. How much did missing my goal impact me?
```

**Response:** 
```
The 2-hour expectation gap resulted in a moderate psychological impact, reducing your perceived satisfaction significantly.
```

## Capabilities

### Score Calculation
Your agent uses this to turn qualitative ratings into a single numerical value.

### Gap Analysis
Your AI client calculates the psychological weight of missing sleep targets.

### Factor Identification
Your agent isolates the specific elements that helped or hindered your rest.

### Actionable Advice
Your AI client suggests specific areas to focus on for better sleep quality.

## Use Cases

### Daily Sleep Audits
Input your nightly ratings to see how your satisfaction score fluctuates over time.

### Goal Tracking
Measure how much missing your target sleep hours actually affects your mood and satisfaction.

### Pattern Recognition
Use the tool to find out if low depth or low continuity is your most frequent sleep inhibitor.

### Personalized Optimization
Get specific suggestions on what to change based on your unique sleep drivers.

## Benefits

- Converts subjective ratings into a single, measurable satisfaction score.
- Identifies the specific drivers and inhibitors of your sleep quality.
- Quantifies the psychological impact of missing your sleep duration goals.
- Provides specific areas for improvement based on your actual data.

## How It Works

Connecting this MCP to your AI client gives your agent the ability to process sleep data instantly.

1. Connect the MCP to your preferred client like Claude or Cursor via Vinkius.
2. Provide your sleep ratings for quality, depth, and continuity to your agent.
3. Include your target sleep duration to account for the expectation gap.
4. The agent calls the tools to calculate scores and identify factors.
5. Receive a detailed breakdown of your sleep satisfaction and improvement areas.

## Frequently Asked Questions

**What can this MCP do with my sleep data?**
It calculates a holistic satisfaction score, identifies what helped or hindered your sleep, and measures the impact of missing your sleep goals.

**How does it handle missed sleep goals?**
It uses the expectation gap tool to quantify the psychological impact of the difference between your actual sleep and your target duration.

**Do I need to provide specific ratings?**
Yes, the tools work best when you provide qualitative ratings for sleep quality, depth, and continuity.

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

**Is this just a sleep tracker?**
No, it is an analytical engine that turns your subjective sleep feelings into quantifiable data and actionable insights.