# Meditation Session Planner MCP MCP > Meditation Session Planner structures deep rest into actionable steps. It takes your personal goals—like focus or better sleep—and maps out a complete session plan, allocating specific time chunks for grounding, core practice, and integration phases. ## Overview - **Category:** wellness - **Price:** Free - **Tags:** meditation, mindfulness, anxiety relief, sleep, focus ## Description Feeling like meditation is just floating in a void? This MCP gives you structure. Instead of guessing how long to meditate or what phase to tackle next, your agent handles the entire process from start to finish. You simply tell it your goal—maybe managing anxiety or needing better sleep—and it generates an ideal session outline. It then allocates specific time blocks for each stage and pulls detailed instructions on exactly what to do during that period. This is critical because a plan helps you stay anchored, even when the process feels unstructured. Because this MCP works within Vinkius, you can chain its output with other tools; for example, taking the resulting session goal and passing it through an external journaling tool to track your progress over weeks of practice. ## Tools ### allocate_durations Assigns time limits to different phases of a meditation session, requiring a minimum of 5 and maximum of 60 minutes. ### get_practice_guidance Looks up detailed instructions for specific meditation phases (Grounding, Core Practice, Integration) based on your goal. ### plan_session Generates a full meditation structure tailored to a user's stated mental goal, such as sleep or anxiety relief. ## 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-Based Outlines It plans a full meditation structure based on defined goals like focus or anxiety relief. ### Allocate Time Segments You set the total time, and it breaks that duration into manageable chunks for each session phase. ### Retrieve Phase Guidance It pulls detailed instructions on specific meditation phases like Grounding or Integration. ### Determine Optimal Structure The tool finds the best practice sequence for a given mental state, ensuring you hit all necessary components. ## Use Cases ### I need to prep for a high-stakes presentation. A user tells their agent they have 30 minutes and want to improve focus. The agent uses `plan_session` (goal='focus'), then allocates time with `allocate_durations`, and finally pulls detailed breathing techniques via `get_practice_guidance`. They walk away with a precise, minute-by-minute plan. ### I can't sleep because of work anxiety. Instead of aimlessly scrolling until midnight, the user asks for help. The agent uses `plan_session` (goal='sleep') and then calls `get_practice_guidance` to retrieve specific body scan instructions, making the last 20 minutes count. ### I have a limited time slot on my lunch break. The user only has 15 minutes. The agent first runs `plan_session`, then immediately uses `allocate_durations` for the totalMinutes=15, ensuring the session is both targeted and achievable. ### I need to teach a group of people how to start meditating. The coach uses the MCP's structure to generate an optimal plan, providing clear instructions on pacing (using `allocate_durations`) and content for all three phases using `get_practice_guidance`. ## Benefits - Stop wasting time guessing. The `plan_session` tool immediately gives you a structured, goal-oriented outline—whether that's anxiety relief or improving focus. - It handles timing perfectly. You provide total minutes, and the `allocate_durations` tool divides those minutes into necessary phases so you never run out of time halfway through. - You get actionable content. Instead of general advice, the `get_practice_guidance` tool pulls specific techniques for each phase like Grounding or Core Practice. - It builds confidence in practice. By following a structured plan derived from the MCP, you build consistency that's hard to maintain when the process feels too open-ended. - You can combine it with other services. Because this runs on Vinkius, your agent can chain the session goal into an external tracker for long-term habit building. ## How It Works The bottom line is that your agent moves you from a vague idea of 'meditate' to a precise, timed sequence of actions. 1. Start by telling your agent your overall goal (e.g., 'I need to improve focus'). This runs the initial planning phase. 2. Next, input the total time you have available for the session so it can allocate appropriate minutes across all required stages. 3. Finally, use the resulting phases and goals to pull specific, detailed guidance on what techniques to perform at each step. ## Frequently Asked Questions **How do I use the `plan_session` tool?** You tell your agent your goal (like 'anxiety') or desired outcome. The tool returns a high-level structure showing which phases are necessary for that specific objective. **What is the difference between `allocate_durations` and `plan_session`?** `plan_session` tells you *what* phases you need. `allocate_durations` takes those required phases and sets concrete, timed limits for them. **Do I need to use all three tools? What if I skip `get_practice_guidance`?** No, but it's best practice. If you only run the planning steps without guidance, you know *what* to do but not *how*. The guidance tool gives you the actual techniques. **Can I plan a session for anxiety relief and then track my progress?** Yes. Since this MCP runs on Vinkius, your agent can take the resulting goal data from `plan_session` and pass it to an external logging or journaling tool for tracking. **What happens if I try to run `allocate_durations` with a time outside of the required range?** The MCP immediately returns an explicit error message. The system enforces that duration must be between 5 and 60 minutes, so your agent will get clear feedback on invalid input before continuing the plan. **How do I ensure the phases used for `get_practice_guidance` are correct?** The best way is to run `plan_session` first. The resulting output provides the specific, valid phase names—Grounding, Core Practice, and Integration—that you must then pass into the guidance tool. **Can I use the structured plan generated by `plan_session` in other tools or systems?** Yes. The output from this MCP is clean data. You can easily capture that structure and feed it directly to messaging tools, note-taking services, or other agents within your workflow. **If I have a complex goal, how does the system handle multiple stages when calling `plan_session`?** The tool handles complexity by generating an ordered sequence of steps based on your stated goals. You simply follow that order: run `plan_session`, use its output for `allocate_durations`, and then call `get_practice_guidance` sequentially.