# Habit Streak Analyzer AI Agent Connect

> Habit Streak Analyzer MCP lets your AI client process raw date lists to find patterns in your consistency. It calculates active streaks, identifies your historical best, and provides performance summaries. Instead of manually counting days, you just hand your completion logs to your agent and get immediate answers about your progress.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_xFx1GHIclw7YPM5qfY6F5G1RHpDfHfNssiOzoink/ai-agent-connect
- **Tags:** habit, streak, productivity, data-analysis, tracking

## Description

You have a list of dates where you completed a task, but looking at a raw list of timestamps doesn't tell you how consistent you actually are. This MCP changes that by turning those dates into clear metrics. You can hand a messy list of completion dates to your AI client and ask it to find your current momentum or see how far you've come in the past. It handles the math of checking for gaps and calculating consecutive runs. Whether you are tracking fitness, coding sessions, or daily reading, your agent can now tell you exactly where you stand without you having to count days on a calendar. It's a simple way to add a layer of analytical intelligence to your personal habit tracking.

## Tools

### get_current_streak
This tool finds your active streak by looking for the most recent consecutive days of completion.

### get_longest_streak
Use this to identify the highest number of consecutive days you have ever completed a habit in your history.

### get_streak_stats
This tool generates a full performance summary including total days and break counts.

### verify_streak_continuity
This tool checks if a specific date is part of an unbroken sequence of completions.

## Prompt Examples

**Prompt:** 
```
What is my current streak for the dates 2023-10-01, 2023-10-02, and 2023-10-03?
```

**Response:** 
```
Your current streak is 3 days.
```

**Prompt:** 
```
What was my longest streak given these dates: 2023-01-01, 2023-01-02, 2023-01-05, 2023-01-06, 2023-01-07?
```

**Response:** 
```
Your longest streak was 3 days.
```

**Prompt:** 
```
Give me a full summary of my habit performance for 2023-11-01, 2023-11-02, 2023-11-04.
```

**Response:** 
```
Current streak: 2, Longest streak: 2, Total days completed: 3, Streak break count: 1.
```

## Capabilities

### Streak Calculation
Your agent calculates consecutive days from any provided list of dates.

### Historical Benchmarking
The AI finds your all-time best performance within a dataset.

### Continuity Verification
Your client checks if specific dates fit into an existing unbroken run.

### Performance Summaries
The MCP provides a breakdown of total completions and streak breaks.

## Use Cases

### Fitness Tracking
Hand your gym attendance dates to your agent to see your current workout streak.

### Learning Progress
Analyze how many days in a row you have practiced a new language or instrument.

### Coding Consistency
Check your daily commit history to find your longest streaks of active development.

### Daily Journaling
Verify if you have maintained a continuous streak of writing entries.

## Benefits

- Eliminates manual date counting and math errors.
- Converts raw date lists into structured performance metrics.
- Provides instant answers about habit momentum.

## How It Works

You connect the MCP to your client and then provide your data.

1. Connect the MCP to your preferred client like Claude or Cursor via Vinkius.
2. Provide a list of completion dates to your AI agent.
3. Ask the agent to calculate streaks or performance stats.
4. The agent uses the MCP tools to process the dates and return the results.

## Frequently Asked Questions

**How do I use this MCP with my AI?**
You connect to the MCP through the Vinkius platform. Once connected, any MCP-compatible client like Claude or Cursor can use the tools directly.

**What kind of data does this MCP need?**
The MCP requires a list of completion dates to perform its calculations.

**Can I find my all-time best streak?**
Yes, you can use the get_longest_streak tool to find the maximum consecutive days in your history.

**Does this work with any AI client?**
It works with any client that supports the Model Context Protocol, such as Claude, Cursor, and Windsurf.

**Can it tell me if I broke my streak?**
Yes, the get_streak_stats tool provides a summary that includes the count of streak breaks.

**What format should the dates be in?**
All dates must be provided in ISO 8601 format (e.g., '2023-10-01').

**How is a streak considered broken?**
A streak is broken if there is a gap of one or more full calendar days between two completion dates.

**Can I see my total number of completed days?**
Yes, you can use `get_streak_stats` to retrieve the total number of unique days completed.