# Breathing Cycle Counter AI Agent Connect

> Breathing Cycle Counter MCP gives your AI client the ability to process and analyze respiratory data. It calculates total breathing cycles, validates physiological parameters, and categorizes session intensity. You can use it to turn simple duration and rate inputs into structured wellness reports or quick summaries.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_paQtY5IC084vd0URY96oAOQ5e3IKSeR9suClh3VB/ai-agent-connect
- **Tags:** breathing, respiration, wellness, health-metrics, fitness

## Description

You can use this MCP to turn raw breathing data into actionable insights. Instead of manually calculating cycles or trying to interpret what a specific breathing rate means, you let your agent handle the math and the classification. It works by taking session duration and breathing rates to provide a full picture of respiratory activity. 

If you are tracking wellness data, you can use it to ensure your metrics stay within realistic physiological bounds. It also handles the heavy lifting of summarizing session data into natural language, making it easy to generate reports or logs. Whether you need to know the total number of breaths taken or want to classify a session as relaxing or intense, this MCP provides the specific tools to get those answers instantly.

## Tools

### get_session_intensity_category
This tool classifies the intensity of a breathing session. It tells your agent if a session falls into a specific category based on the provided rates.

### get_total_cycles
This tool calculates the cumulative count of breathing cycles. It uses the session duration and rate to find the total number of breaths.

### summarize_session_metrics
This tool generates a natural language overview of a session. It turns raw numbers into a readable summary of the breathing activity.

### validate_breathing_parameters
This tool checks that your respiratory metrics are physiologically plausible. It ensures the data you are working with makes sense for a human.

## Prompt Examples

**Prompt:** 
```
How many breathing cycles are in a 10 minute session with 12 cycles per minute?
```

**Response:** 
```
There are 120 breathing cycles in that session.
```

**Prompt:** 
```
What is the intensity category for a breathing rate of 6 cycles per minute?
```

**Response:** 
```
The intensity category is Slow/Relaxing.
```

**Prompt:** 
```
Summarize a 5 minute session at 15 cycles per minute.
```

**Response:** 
```
The session lasted 5 minutes at a rate of 15 cycles per minute, resulting in 75 total breathing cycles.
```

## Capabilities

### Cycle Calculation
Your agent uses this to find the total number of breaths in any given timeframe.

### Intensity Classification
The agent identifies if a breathing session is relaxing or intense.

### Data Validation
Your agent checks that breathing rates are within realistic human limits.

### Metric Summarization
The agent converts raw session data into a written summary.

## Use Cases

### Wellness Reporting
An agent summarizes a user's breathing session after a meditation period.

### Data Integrity Checks
A user validates that a sensor's breathing rate reading is physiologically possible.

### Fitness Tracking
The agent classifies a breathing session as relaxing or intense based on the rate.

### Quick Calculations
A user gets the total breath count for a specific duration without manual math.

## Benefits

- Automates the math for total breathing cycles.
- Flags unrealistic respiratory data through parameter validation.
- Converts raw numbers into readable text summaries.
- Categorizes session intensity automatically.

## How It Works

Connecting this MCP to your client gives your agent immediate access to respiratory calculation tools.

1. Connect the MCP to your client like Claude or Cursor via Vinkius.
2. Provide your agent with session duration and breathing rate data.
3. The agent calls the necessary tool to calculate or validate the data.
4. Your agent delivers the final summary or classification to you.

## Frequently Asked Questions

**What can this MCP do with breathing data?**
It calculates total breathing cycles, validates that rates are realistic, summarizes session metrics, and categorizes session intensity.

**Which AI clients can use this MCP?**
You can use this with any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code.

**How does it categorize breathing intensity?**
It uses the provided breathing rate to determine the intensity category, such as Slow/Relaxing.

**Do I need to host the MCP myself?**
No, Vinkius hosts and manages the MCP for you, so it is ready to use immediately after you connect.

**Can it check if my breathing data is wrong?**
Yes, the validate_breathing_parameters tool checks if the metrics are physiologically plausible.

**How do I calculate the total number of breaths?**
You can use the `get_total_cycles` tool by providing the session duration in minutes and the breathing rate per minute.

**Can this tool validate if my breathing rate is normal?**
Yes, the `validate_breathing_parameters` tool checks if your session metrics fall within plausible physiological limits.

**How can I see a summary of my session?**
The `summarize_session_metrics` tool provides a formatted overview including duration, rate, and total cycles.