# Breathing Timer MCP MCP > Breathing Timer provides structured guidance for respiratory exercises like Box Breathing, 4-7-8, and Coherence Heart Rate. It moves beyond simple countdowns by accurately calculating cycle durations and generating full, guided schedules. This MCP gives you precise timing so you can focus entirely on the rhythm, regardless of your current stress level. ## Overview - **Category:** health - **Price:** Free - **Tags:** breathing, respiration, meditation, stress-relief, circadian ## Description Need to reset your focus? Controlled breathing is a foundational skill for managing stress, but hitting those perfect timings—like 4 seconds in, 7 seconds hold, 8 seconds out—is tough to maintain manually. This MCP handles all the math and timing structure so you don't have to worry about it. It connects your agent directly to core physiological rhythm tracking. For example, if you need a specific routine, you can set the total session length, and the system generates a cycle-by-cycle countdown. If you’re unsure what timings to use, you can query default parameters for established techniques like Coherence Heart Rate. This reliability is key; when paired with other MCPs—say, one that tracks your mood or logs your meditation notes—you build automations spanning multiple platforms, all through one agent running on Vinkius. The platform ensures every tool call produces a cryptographically signed audit trail, so you always know exactly what data flowed and how the session was structured. You get a reliable practice that lets you focus solely on the breath. ## Tools ### calculate_single_cycle_duration Calculates the total time needed for one full breathing cycle based on user inputs for inhale, hold, and exhale times. ### generate_breathing_schedule Creates a detailed, structured countdown schedule that spans a specified total session duration. ### query_breathing_parameters Retrieves the scientifically default timing parameters for known breathing techniques like Wim Hof or Coherence Heart Rate. ## Prompt Examples **Prompt:** ``` I need a 15-minute session using the 4-7-8 technique. Start now. ``` **Response:** ``` Okay, starting your 15-minute 4-7-8 cycle schedule. The first phase is INHALE (count of 4). Remember to breathe deeply and consistently. We will continue the pattern for the next 15 minutes. ``` **Prompt:** ``` What are the standard timing parameters for Coherence Heart Rate? ``` **Response:** ``` According to our catalog, the default parameters for Coherence Heart Rate (COHERENT) are: Inhale: 5 seconds, Hold After Inhale: 0 seconds, Exhale: 5 seconds, Rest: 0 seconds. This means one full cycle takes 10 seconds. ``` **Prompt:** ``` Calculate the duration for a custom Box Breathing cycle using 3s inhale and 5s exhale. ``` **Response:** ``` I have calculated your customized Box Breathing cycle duration. With 3 seconds inhale, 3 seconds hold, 5 seconds exhale, and 3 seconds rest, one full cycle will take a total of 14 seconds. ``` ## Capabilities ### Set up default patterns Quickly retrieves scientifically backed timing parameters for established breathing techniques. ### Determine cycle duration Calculates the precise total time needed for one complete breath cycle based on user-defined timings. ### Create full schedules Generates a structured, guided countdown schedule for any desired total session length. ## Use Cases ### Pre-Presentation Anxiety A sales director needs a quick reset before speaking. They ask their agent: 'I need a 10-minute stress reduction routine using the 4-7-8 method.' The MCP generates the full schedule, giving them moment-by-moment guidance right up to the meeting start. ### Designing Custom Therapy Protocols A physical therapist needs to create a new cycle for a patient with specific limitations. They use `query_breathing_parameters` to get baseline data, then manually calculate adjustments using `calculate_single_cycle_duration` before generating the final plan. ### Focus Block Timing A developer needs sustained focus for 90 minutes. They prompt their agent: 'Generate a full schedule that alternates between Box Breathing and deep rest cycles.' The MCP handles the complex, structured timing across the entire work block. ### Rapid Skill Onboarding A trainer needs to teach basic breathing techniques. They ask the agent: 'What are the standard parameters for Coherence Heart Rate?' This provides an immediate reference point they can build around, minimizing instructional time. ## Benefits - Never guess a pattern. Use `query_breathing_parameters` to pull the scientific standards for techniques like Coherence Heart Rate, ensuring you're following proven timing protocols. - Stop counting breaths manually. The MCP handles all cycle math, letting your agent calculate single-cycle durations so you can focus on the breath itself, not the clock. - Need a full session? Instead of just one minute of guidance, use `generate_breathing_schedule` to create a complete countdown for 15 or 30 minutes straight. - The system keeps track of everything. Because this MCP runs on Vinkius, you get full visibility into what every agent does—every cycle time and parameter retrieved is logged in the audit trail. - It works with your existing tech stack. Connect once from any compatible client (Claude, Cursor, Windsurf, VS Code) to manage all your health routines without switching platforms. ## How It Works The bottom line is that you get precise, guided timing without having to count or calculate anything yourself. 1. First, specify the breathing technique or custom parameters you want to use (e.g., 4s inhale, 7s hold). 2. Second, the MCP calculates the total time for one complete cycle based on those inputs. 3. Third, provide the desired overall session length and receive a moment-by-moment countdown schedule. ## Frequently Asked Questions **How does `query_breathing_parameters` work?** The tool fetches established timing data for known techniques (like Coherence Heart Rate). This means you get the scientifically accepted standards, not just a guess. **What is the difference between using this MCP and a basic timer?** A basic timer only tracks elapsed time. This MCP structures the time into specific cycles (inhale/hold/exhale), giving you guided, rhythmic breathing patterns that change over time. **Can I calculate a custom cycle using `calculate_single_cycle_duration`?** Yes. You input your own timings—whether they are based on scientific research or personal preference—and the tool calculates the exact total duration for one full cycle. **Does `generate_breathing_schedule` support multiple techniques?** It generates a continuous schedule based on your inputs. You can feed it parameters that combine different patterns into one cohesive, timed session. **When I use `generate_breathing_schedule`, is my personal timing data stored anywhere?** No, your session data isn't saved. The MCP processes the request inside a secure V8 sandbox and discards all temporary breathing cycle information immediately after the schedule finishes. **What happens if I input invalid values when calling `calculate_single_cycle_duration`?** The function rejects the call instantly. It returns a specific error message, telling you exactly which component (inhale, hold, etc.) needs to be a positive numeric value. **Do I need special setup or permissions to use `query_breathing_parameters`?** No. Once your AI client connects through Vinkius, you can access the MCP tools immediately. The entire service runs within a secure sandbox with strict rules applied to every call. **Are there usage limits or rate limits when running `generate_breathing_schedule`?** There are no hard quotas for individual users. However, making too many calls in a very short time might trigger standard API rate limiting enforced by the Vinkius platform.