# Meditation Session Planner MCP

> Meditation Session Planner gives you a structured path for deep rest. It plans full meditation sessions based on your mental goal, allocating specific time blocks and providing detailed guidance for each stage—whether you need focus, sleep, or anxiety relief.

## Overview
- **Category:** wellness
- **Price:** Free
- **Tags:** meditation, mindfulness, anxiety-relief, sleep, focus

## Description

Feeling overwhelmed by the idea of starting meditation? You don't have to guess how long things should last or what phase comes next. This MCP builds a complete session plan tailored exactly to your time limits and mental objective. It walks you through everything required for deep rest. Instead of getting generic advice, your agent structures the full process: first, it determines the best overall approach based on goals like focus or sleep. Then, it assigns specific minutes to each stage. Finally, it generates precise instructions for every phase—from initial grounding exercises to core practices. Connecting this MCP through Vinkius means you get a comprehensive guide right where you work, turning vague intentions into actionable steps.

## Tools

### allocate_durations
This tool determines the specific number of minutes needed for each phase of your meditation session.

### get_practice_guidance
It provides written instructions and guidance for a specified meditation stage and overall goal.

### plan_session
This tool generates the core structure of an entire session based on your primary mental objective (like focus or sleep).

## Prompt Examples

**Prompt:** 
```
I have 20 minutes available. My main goal is improving focus on work tasks.
```

**Response:** 
```
First, run `plan_session` with goal='focus'. Next, use `allocate_durations` for totalMinutes=20. Finally, call `get_practice_guidance` using the resulting phases and 'focus' as context to get detailed instructions.
```

**Prompt:** 
```
I am highly anxious right now and only have 10 minutes. Give me a plan.
```

**Response:** 
```
Start by running `plan_session` with goal='anxiety'. Then, use `allocate_durations` for totalMinutes=10. The output will guide you on how to proceed immediately using `get_practice_guidance`.
```

**Prompt:** 
```
I want a gentle session for sleep, and I have 45 minutes. Plan it out.
```

**Response:** 
```
Use `plan_session` with goal='sleep' to get the ideal structure. Run `allocate_durations` for totalMinutes=45. Then, use `get_practice_guidance` on each phase name that results.
```

## Capabilities

### Generate Goal-Oriented Plans
You tell it your objective (like reducing anxiety or improving sleep), and it builds the foundational structure for the entire session.

### Allocate Time Blocks
It calculates how many minutes to spend in each distinct phase of meditation, respecting minimum and maximum time limits you set.

### Get Phase-Specific Guidance
You receive detailed instructions for any specific stage—Grounding, Core Practice, or Integration—based on the established goal.

## Use Cases

### Designing an Emergency Anxiety Module
A coach needs a short plan for a client who is highly anxious and has only 10 minutes. They first use `plan_session` with goal='anxiety'. Then they run `allocate_durations` for totalMinutes=10, and finally pull specific instructions using `get_practice_guidance` to ensure the module is targeted.

### Creating a Sleep Prep Routine
A user wants to build a 45-minute wind-down routine for sleep. They start with `plan_session` using goal='sleep', run `allocate_durations` for the full time, and then get detailed guidance on each phase name that results.

### Developing a Work Focus Session
An employee needs to build a 20-minute focus block before a major meeting. They use `plan_session` with goal='focus' and then immediately call `allocate_durations` for totalMinutes=20, ensuring the plan meets professional requirements.

## Benefits

- Stop guessing how long a session should be. Run `plan_session` to nail down the structure first, then use `allocate_durations` to assign precise minutes for total control.
- You get specific instructions instead of generic advice. After planning the structure, call `get_practice_guidance` for detailed steps on Grounding or Core Practice.
- It handles multiple goals easily. Whether you're trying to reduce anxiety or improve self-awareness, the MCP uses your target goal to guide all subsequent planning calls.
- Avoid feeling lost during a session. The combination of `plan_session` and `get_practice_guidance` gives you a complete script for guiding yourself or others through any phase.
- It builds complexity from simplicity. You just input a time limit (5 to 60 minutes), and the tool breaks it down into manageable, actionable steps.

## How It Works

The bottom line is: it takes a vague idea of 'I should meditate' and turns it into a minute-by-minute instructional guide.

1. First, input your desired meditation goal and overall time commitment to generate a complete session plan.
2. Next, use that output to allocate precise minutes for each phase in the schedule, ensuring the total duration matches your time limit.
3. Finally, request detailed practice guidance for every resulting phase using the assigned focus area.

## Frequently Asked Questions

**What goals can I use with Meditation Session Planner?**
The planner supports four main goals: focus, sleep, anxiety, and self-awareness. You just tell your agent which one you're targeting.

**How do I make sure the total time matches my limit using allocate_durations?**
You run `allocate_durations` after planning the session, providing a specific total minute count. The tool then distributes that time across all necessary phases.

**Is this MCP good for beginners who don't know where to start?**
Yes. You can use `plan_session` first. This ensures you get a foundational structure, even if it’s your first time doing it.

**Does Meditation Session Planner support different types of phases?**
It supports the required valid phases: Grounding, Core Practice, and Integration. These three are used to build a complete mental rest journey.

**Can I plan a session for something other than focus or sleep?**
The MCP is designed around those specific goals (anxiety, self-awareness) because the guidance tools need that context to deliver accurate instructions.

**What if I don't know the right structure for my goal?**
Start with `plan_session`. This tool uses your stated goal (like 'anxiety') to map out the mandatory sequence of phases, ensuring you begin with grounding techniques before progressing.

**How does the planner manage my total time limit?**
After `plan_session` defines the phases, you must use `allocate_durations`. This tool takes your minutes (5-60) and intelligently distributes them across all required stages, preventing any single phase from being neglected.

**Can I get specific instructions for a phase?**
Yes. Once you have the phase name (e.g., 'Core Practice') and your goal, run `get_practice_guidance`. This tool provides detailed, actionable guidance specific to both the technique and your mental objective.