# Breathing Timer MCP

> Breathing Timer MCP accurately guides your respiratory practice. It helps you maintain precise breath patterns like Box Breathing or 4-7-8 without manual counting errors. Your agent connects to this MCP to calculate specific cycle durations, reference established physiological timings, and run structured, timed sessions for focused stress relief and mental reset.

## Overview
- **Category:** health
- **Price:** Free
- **Tags:** breathing, respiration, meditation, stress-relief, circadian

## Description

Trying to meditate or manage acute stress often requires focusing on your breath—a skill that needs precise timing. But keeping count of a 4-7-8 pattern, especially when you're already stressed, is nearly impossible. This MCP takes the guesswork out of deep breathing. It connects your agent to core physiological rhythm tracking, providing reliable structure and flawless counting for guided practice. Instead of relying on memory or imperfect timers, your AI client handles the timing perfectly. You simply tell it how long your session needs to be, and it guides you through every inhale, hold, and exhale. This level of precision is critical when practicing techniques like Coherence Heart Rate. By connecting this MCP via Vinkius, you gain immediate access to a reliable tool that keeps your focus entirely on the breath, not the count.

## Tools

### calculate_single_cycle_duration
Determines the total seconds required for one complete breath cycle based on your custom inhale, hold, and exhale times.

### query_breathing_parameters
Retrieves the official default timing values for established breathing techniques like Coherence Heart Rate.

### generate_breathing_schedule
Creates a timed, structured schedule that counts down through specific cycles for your desired total session length.

## 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

### Generate timed breathing schedules
The agent runs structured countdowns for deep breathing sessions based on total time and cycle patterns.

### Determine standard parameters
Your client queries the scientifically backed default timings for established techniques like Wim Hof or Coherent Heart Rate.

### Calculate custom cycle duration
The agent computes the precise total time needed for one full breath cycle using any user-defined timing inputs.

## Use Cases

### Resetting focus during marathon coding sessions
The developer realizes they’ve been staring at code for two hours and need to reset. They prompt their agent: 'Start a 10-minute session using Box Breathing.' The agent uses `generate_breathing_schedule` to guide them through the pattern, allowing them to break concentration without losing structure.

### Preparing for high-stakes negotiations
A sales executive needs a rapid calming exercise before a meeting. They ask their agent what the default parameters are for deep breathing and use `query_breathing_parameters` to confirm the standard cycle timings, ensuring they start with validated science.

### Customizing breath work for specific fitness goals
A client wants to tailor a unique respiratory routine. They ask their agent to calculate the duration for 4 seconds of inhale and 6 seconds of exhale. The agent uses `calculate_single_cycle_duration` to give them the precise total cycle time.

### Leading guided meditation groups online
A wellness coach runs a virtual session for ten people. They tell their agent: 'Run a 20-minute Coherence Heart Rate schedule.' The agent uses `generate_breathing_schedule` to manage the timing, freeing the coach up to focus on the group's energy.

## Benefits

- You stop relying on memory or guesswork. The ability to calculate single-cycle duration means your agent can handle custom cycles (like 3s in, 5s ex) instantly using `calculate_single_cycle_duration`.
- Your sessions are always accurate. Instead of a basic timer that drifts, the MCP runs structured countdowns, ensuring every cycle adheres to the exact timing needed for optimal physiological effect via `generate_breathing_schedule`.
- You get professional defaults without research. Need Coherence Heart Rate timings? Use `query_breathing_parameters` to pull scientifically validated starting points right away.
- The process is hands-free. You just set the total time and desired pattern, and your AI client manages the moment-by-moment guidance for you.
- It supports varied needs. Whether it's a quick 5-minute reset or a deep 30-minute meditation, the scheduling capability adapts instantly.

## How It Works

The bottom line is, your agent provides flawless timing so you can focus entirely on regulating your breath instead of counting seconds.

1. You first tell your AI client what kind of breathing technique you want to use and how long the session should last.
2. The MCP calculates the required time for a single cycle using your inputs, or pulls standard timings if you request default parameters. 
3. Finally, it generates a structured schedule that runs moment-by-moment guidance, ensuring perfect timing throughout the entire duration.

## Frequently Asked Questions

**How do I start a 15-minute session using the Breathing Timer MCP?**
You simply instruct your agent that you need a specific duration and technique. The agent will use `generate_breathing_schedule` to immediately begin counting down through the structured cycles.

**What if I don't know the standard timing for Coherence Heart Rate?**
You can ask your agent to run `query_breathing_parameters`. It will retrieve the scientifically accepted default timings, giving you accurate starting data right away.

**Can I customize a cycle duration if it's not standard?**
Yes. Use `calculate_single_cycle_duration` and provide your specific inhale/hold/exhale times. It will tell you the exact total seconds for that custom pattern.

**Is the timing accurate enough for therapeutic use?**
The MCP is built specifically to maintain precise, measured breath patterns. The mechanisms ensure flawless counting, making it reliable for guided practice.