# Habit Completion Rate AI Agent Connect

> Habit Completion Rate MCP gives your AI client the ability to monitor your discipline and consistency. It calculates success percentages, tracks your current and historical streaks, analyzes performance trends over time, and checks your planned routines for logical errors.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_mPGEUF39Lwa7AUYJpMhUSQzBxp9Tyi4gCOnoFQke/ai-agent-connect
- **Tags:** habits, tracking, discipline, metrics, consistency

## Description

You can now give your AI agent a direct window into your habit tracking data. Instead of manually calculating how well you are sticking to your goals, you can ask your AI client to handle the math. This MCP lets you see exactly where your discipline is slipping or where you are building real momentum. You can check your success rates for specific timeframes, see if your consistency is improving or declining, and verify that your planned schedules actually make sense. It turns raw habit logs into a clear picture of your behavior, allowing your agent to provide much more useful feedback on your progress.

## Tools

### get_habit_completion_rate
This tool calculates the percentage of habits you actually finished compared to what you planned to do.

### get_habit_consistency_trend
Use this to compare your completion rates across different time periods to see if you are getting more or less consistent.

### get_habit_streak_info
This tool retrieves your current consecutive success streak and your all-time longest streak for any habit.

### validate_habit_schedule
This tool checks your planned habit routines to find any logical errors or scheduling conflicts.

## Prompt Examples

**Prompt:** 
```
What is my completion rate for habit 'water-intake' from 2024-01-01 to 2024-01-07?
```

**Response:** 
```
Your completion rate for water-intake is 85.7% (6 out of 7 planned days).
```

**Prompt:** 
```
What is my current streak for 'daily-meditation'?
```

**Response:** 
```
Your current streak for daily-meditation is 12 days.
```

**Prompt:** 
```
Is my habit schedule for 'gym' between 2024-05-01 and 2024-05-05 valid?
```

**Response:** 
```
Yes, your schedule for gym is valid.
```

## Capabilities

### Success Rate Calculation
Your agent uses this to tell you exactly what percentage of your goals you are meeting.

### Streak Monitoring
Your AI client tracks how many days in a row you have stayed disciplined.

### Trend Analysis
Your agent compares different time segments to show if your performance is shifting.

### Schedule Validation
Your AI client checks your planned routines to ensure they are logically sound.

## Use Cases

### Weekly Review
Ask your agent to summarize your completion rates for the past seven days to see how you performed.

### Streak Motivation
Check your current streak to see how close you are to hitting a new personal record.

### Routine Planning
Have your agent validate a new workout or meditation schedule before you commit to it.

### Long-term Analysis
Compare this month's consistency against last month to see if your discipline is improving.

## Benefits

- Eliminates manual math for habit success percentages.
- Identifies shifts in discipline through trend comparisons.
- Prevents scheduling errors with automated routine validation.
- Provides instant visibility into current and historical streaks.

## How It Works

Get your habit data into your AI workflow in minutes.

1. Subscribe to the MCP on Vinkius.
2. Connect your preferred client like Claude or Cursor with one click.
3. Ask your agent questions about your habits or streaks.
4. The agent uses the MCP tools to pull and process your data instantly.

## Frequently Asked Questions

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

**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 the AI check if my schedule is realistic?**
Yes, the validate_habit_schedule tool allows your agent to check for logical inconsistencies in your planned routines.

**How does it calculate my success rate?**
The get_habit_completion_rate tool compares the number of successful completions against your total planned commitments.

**Can I see my longest streak?**
Yes, the get_habit_streak_info tool provides both your current consecutive streak and your longest historical streak.

**How is the completion rate calculated?**
The rate is the number of completed days divided by the number of planned days for the selected period.

**Can I check my current streak?**
Yes, you can use `get_habit_streak_info` to see your current consecutive success streak and your historical record.

**How do I know if my habit schedule is valid?**
You can use `validate_habit_schedule` to check for logical errors or impossible frequencies in your planned routine.