# Board Game Session Tracker AI Agent Connect

> Board Game Session Tracker MCP lets your AI agent manage and analyze your tabletop gaming data. It handles everything from logging a single session to calculating total time spent on specific titles or finding your average game length. Instead of manual spreadsheets, your agent keeps the tally for you.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_ERUEd4k3zFTMSMYPpKM1IFMRHl68uzhujSW7ZLWZ/ai-agent-connect
- **Tags:** board-games, time-tracking, gaming, data-aggregation, session-management

## Description

Stop trying to remember how many hours you actually spent playing Catan or Pandemic. This MCP gives your AI client the ability to act as a dedicated gaming logbook. You can tell your agent when a session ends, and it will handle the math, the storage, and the data aggregation. 

If you want to know which games are your biggest time sinks, your agent can pull total time spent per title or show you a full summary of all your recorded games. It can even figure out if your sessions are getting longer or shorter by calculating average session lengths. It is a simple way to turn your chat history into a structured database of your gaming habits without ever opening a spreadsheet.

## Tools

### get_all_game_totals
This tool provides a full summary of all games in your log. It returns the total time spent across your entire collection.

### get_average_session_length
This tool calculates the mean duration of your sessions for a specific game. It helps you understand how long a typical playthrough lasts.

### get_total_game_time
This tool retrieves the cumulative time spent on a single game. Use it to find out exactly how much time you have invested in one title.

### add_game_session
This tool logs a new play session. Tell your agent how long you played a specific game to add it to the database.

## Prompt Examples

**Prompt:** 
```
I just finished playing Catan for 90 minutes. Please record this session.
```

**Response:** 
```
Session recorded successfully. You have now played Catan for a total of 90 minutes.
```

**Prompt:** 
```
How much total time have I spent playing Pandemic?
```

**Response:** 
```
You have spent a total of 120 minutes playing Pandemic.
```

**Prompt:** 
```
What is the average session length for Terraforming Mars?
```

**Response:** 
```
The average session length for Terraforming Mars is 115 minutes.
```

## Capabilities

### Session Logging
Your agent records the duration of a game immediately after you finish playing.

### Time Aggregation
The agent sums up every recorded session for a specific game title.

### Data Summarization
Your agent generates a complete overview of all time spent across all games.

### Duration Analysis
The agent calculates average play times to help you plan future game nights.

## Use Cases

### Post-Game Logging
Tell your agent you just finished a game to instantly save the duration.

### Time Sink Identification
Ask your agent which games you spend the most total time playing.

### Scheduling Prep
Check average session lengths to decide if you have enough time for a specific game.

### Gaming History Review
Request a full summary of all recorded games to see your total hobby engagement.

## Benefits

- Eliminates manual data entry by letting you talk to your logbook.
- Provides instant mathematical summaries of gaming habits.
- Turns conversational chat into a structured time-tracking database.

## How It Works

Connecting this MCP to your AI client gives it immediate access to your gaming database.

1. Connect the MCP to your client like Claude or Cursor via Vinkius.
2. Tell your agent when you finish a game session.
3. Ask your agent for totals, averages, or summaries.
4. Receive instant data analysis based on your recorded history.

## Frequently Asked Questions

**How do I add a new game session?**
Just tell your AI client that you finished playing a game and specify how long it took. The agent uses the add_game_session tool to save it.

**Can I see how much time I've spent on all my games?**
Yes. You can ask your agent for a summary of all game totals, and it will use the get_all_game_totals tool.

**Which AI clients can use this MCP?**
Any MCP-compatible client like Claude, Cursor, or Windsurf can use this tool once connected through Vinkius.

**Does this track my gaming automatically?**
No. You must tell your agent when a session occurs so it can record the data using the add_game_session tool.

**Can it help me plan my next game night?**
Yes. By asking for the average session length of a specific game, you can better estimate how much time you'll need.
