# Book Completion Rate Tracker MCP. AI Agent Connect

> Book Completion Rate Tracker MCP lets your AI client manage your reading data. You can update how many pages you have finished, check your progress on specific titles, and pull aggregate reading statistics. It turns your agent into a personal librarian that tracks exactly how much of your library you have actually finished.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_jSphvFQ6I4Tjn0Dri8UdT8RezmFvOkUgIgAHJn8h/ai-agent-connect
- **Tags:** reading, books, progress, statistics, tracking

## Description

You can stop manually logging your reading progress in spreadsheets or notes. This MCP gives your AI client the ability to act as a dedicated reading assistant. You can tell your agent exactly which page you just reached, and it will handle the math to update your completion percentage. If you want to see how your reading habits look over time, your agent can pull together your total stats across every book you have tracked. It also helps you find books based on how much the community has read, making it easy to identify trending titles or books you might want to pick up next. Whether you are tracking a single novel or managing a massive digital library, this tool keeps your data current and accessible through any MCP-compatible client.

## Tools

### get_book_progress
This tool calculates the exact completion percentage for a specific book and user.

### get_user_reading_stats
Use this to get a full breakdown of reading completion data across all books for a user.

### list_books_by_completion_tier
This tool retrieves a list of books filtered by their global completion status.

### update_reading_progress
This tool lets you update the current page count for a book you are reading.

## Prompt Examples

**Prompt:** 
```
How much of the book 'book_123' has user 'user_456' finished?
```

**Response:** 
```
User 'user_456' has completed 45% of 'book_123', having read 90 out of 200 pages.
```

**Prompt:** 
```
Update my progress for 'book_789' to page 50.
```

**Response:** 
```
Progress updated successfully. Your new completion rate for 'book_789' is 25%.
```

**Prompt:** 
```
Show me books that have a global completion rate between 50% and 80%.
```

**Response:** 
```
The following books have an average completion rate between 50% and 80%: 'book_abc' (62%), 'book_def' (75%).
```

## Capabilities

### Progress Tracking
Your agent calculates completion percentages based on current page counts.

### Data Updates
You can tell your agent to update your reading status instantly.

### Statistical Analysis
Your agent aggregates data to show your overall reading performance.

### Library Filtering
Your agent finds books based on global completion tiers.

## Use Cases

### Daily Reading Logs
Tell your agent you finished page 120 and let it update your progress automatically.

### Reading Habit Analysis
Ask your agent for a summary of your reading stats to see how many books you finish each month.

### Book Discovery
Ask for books that have a high global completion rate to find popular reads.

### Progress Audits
Check exactly how far you are into a specific book before you start a reading session.

## Benefits

- Automates the calculation of completion percentages.
- Centralizes reading data for easy retrieval by your AI client.
- Provides global book data through completion tiers.
- Eliminates the need for manual progress logging.

## How It Works

The setup is handled by Vinkius, so you can start using the tools immediately.

1. Connect your preferred MCP-compatible client to Vinkius.
2. Grant the client access to the Book Completion Rate Tracker MCP.
3. Ask your agent to update your progress or check your stats.
4. The agent executes the specific tool to retrieve or change your data.

## Frequently Asked Questions

**How do I update my reading progress?**
You simply tell your AI client which book you are reading and what page you are on. The agent uses the update tool to save that information.

**Can I see my total reading statistics?**
Yes. You can ask your agent to show you your reading stats, and it will aggregate the data from all your books.

**What clients can I use with this MCP?**
You can use this with any MCP-compatible client like Claude, Cursor, Windsurf, or VS Code.

**Does this track global book data?**
Yes, you can use the tool to list books based on their global completion tiers.

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

**How do I update my current page?**
You can use the `update_reading_progress` tool to set the current page number for a specific user and book.

**How is the completion rate calculated?**
The completion rate is the ratio of pages read to the total number of pages in the book, expressed as a percentage.