# Reading Streak Calculator AI Agent Connect

> Reading Streak Calculator helps you make sense of your reading history. It analyzes lists of dates to find your current streaks, identifies where you fell off track, and provides summary statistics on your reading frequency. You can plug your reading logs into any MCP-compatible client to get instant insights into your consistency.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_QGUXsyQ45P5Kqq7WmUOaaQfUteLcptw1QDUED8Wz/ai-agent-connect
- **Tags:** reading, streaks, habit-tracking, analytics, productivity

## Description

If you keep a log of when you read, this MCP turns those raw dates into a clear picture of your habits. Instead of manually counting days to see if you're staying consistent, you can hand your list of dates to your AI client and get immediate answers. You can find out exactly how many days you've read in a row or identify the specific gaps where you lost momentum. It also cleans up your data by checking for duplicate entries or chronological errors. Whether you're trying to build a daily reading habit or just want to see how your reading frequency changes over time, this tool handles the math so you can focus on the books.

## Tools

### calculate_streaks
This tool finds your current ongoing streak and your all-time longest streak from a list of dates.

### get_streak_gap_analysis
Use this to pinpoint exactly where breaks or gaps occurred in your reading history.

### get_streak_metadata
This tool provides summary statistics regarding how often and how you distribute your reading days.

### validate_date_consistency
This tool checks your list of dates to ensure there are no duplicates and that the timeline is logical.

## Prompt Examples

**Prompt:** 
```
Calculate my reading streaks for these dates: 2024-05-01, 2024-05-02, 2024-05-03, 2024-05-05.
```

**Response:** 
```
Your current streak is 1 day and your longest streak is 3 days.
```

**Prompt:** 
```
How many gaps are in my reading history for: 2024-01-01, 2024-01-02, 2024-01-04, 2024-01-05?
```

**Response:** 
```
There is 1 gap in your reading history, with a gap length of 1 day.
```

**Prompt:** 
```
Check if these reading dates are consistent: 2024-06-01, 2024-06-01, 2024-06-02.
```

**Response:** 
```
The dates are not consistent. There is 1 duplicate entry found.
```

## Capabilities

### Streak Calculation
Your agent calculates current and all-time high streaks from date lists.

### Gap Detection
The AI identifies specific periods where you stopped reading.

### Data Validation
Your client checks for duplicate dates or chronological errors in your logs.

### Activity Summaries
The tool generates metadata about your reading frequency and distribution.

## Use Cases

### Habit Maintenance
Check your current streak to stay motivated to read today.

### Pattern Analysis
Find out if you tend to skip reading more often on certain days of the week.

### Log Cleanup
Run a consistency check to fix errors in your reading journal.

### Progress Review
Use metadata to see how your reading frequency has changed over months.

## Benefits

- Automates the math behind streak tracking.
- Identifies specific dates where reading habits broke.
- Cleans up messy or duplicate date logs.
- Provides statistical density of reading activity.

## How It Works

Connect the MCP to your client and provide your reading dates.

1. Connect the MCP to Claude, Cursor, or Windsurf via Vinkius.
2. Paste your list of reading dates into your AI client.
3. Ask your agent to calculate streaks or analyze gaps.
4. Receive immediate statistical feedback on your reading habits.

## Frequently Asked Questions

**How do I use this MCP with my AI client?**
You connect to the MCP through the Vinkius platform. Once connected, your AI client can immediately use the tools by simply asking it to process your reading dates.

**Can this tool find my longest reading streak?**
Yes, the calculate_streaks tool specifically identifies both your current ongoing streak and your all-time highest streak.

**What happens if my date list has duplicates?**
The validate_date_consistency tool will detect duplicate entries and alert you that the list is inconsistent.

**Can I see where I missed days of reading?**
Yes, the get_streak_gap_analysis tool identifies the specific breaks in your reading history.

**Does this work with any reading app?**
It works with any list of dates. You just need to provide the dates to your AI client, and the MCP handles the analysis.

**How is the current streak calculated?**
The current streak is active if your most recent reading date is either today or yesterday. If there is a gap of more than one day, the current streak is reset to zero.

**What format should the dates be in?**
All dates must be provided as ISO 8601 strings in the format YYYY-MM-DD.

**Can I see where I missed reading days?**
Yes, you can use the `get_streak_gap_analysis` tool to identify the number of breaks and the length of each gap in your reading history.