# Team Roster Count AI Agent Connect

> Team Roster Count MCP lets your AI client manage player availability and roster integrity. It tracks three specific statuses: Active, Reserve, and Absent. You can use it to monitor team breakdowns, check individual player availability, or update statuses on the fly through your preferred AI interface.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_SVtsNl9biJ2cJhg60XN15ou1QIG47vtmCOpV0q3x/ai-agent-connect
- **Tags:** roster, sports, team, players, status, availability

## Description

Managing a sports roster shouldn't involve digging through spreadsheets every time a player calls in sick. This MCP gives your AI agent direct control over your team's availability. You can track exactly who is Active, who is on the Reserve list, and who is currently Absent. 

Instead of manual data entry, you just tell your AI client what changed. If a player moves from the reserve list to the active roster, your agent handles the update. If you need to know how many players are ready for a game, your agent pulls the summary instantly. It keeps your roster data clean and organized so you can focus on coaching or managing rather than administrative busywork.

## Tools

### get_roster_summary
This tool provides a high level count of your entire team. Use it to see the total number of Active, Reserve, and Absent players at once.

### list_players_by_status
This tool filters your roster to show only players with a specific status. Use it to quickly see everyone currently marked as Active or Absent.

### update_player_status
This tool changes a player's current availability. Use it to move a player between Active, Reserve, or Absent states.

### get_player_status
This tool retrieves the name and current status of a single player. Use it to check if a specific person is available for a game.

## Prompt Examples

**Prompt:** 
```
What is the current breakdown of my team (ID: team-123)?
```

**Response:** 
```
The team (team-123) has 15 active players, 3 reserve players, and 2 absent players, for a total of 20 players.
```

**Prompt:** 
```
What is the status of player 'p-99' in team 'team-123'?
```

**Response:** 
```
Player p-99 (John Doe) is currently in Reserve status.
```

**Prompt:** 
```
Set player 'p-45' in team 'team-123' to Active.
```

**Response:** 
```
The status for player p-45 (Jane Smith) has been successfully updated to Active.
```

## Capabilities

### Real-time Status Tracking
Your agent monitors Active, Reserve, and Absent counts as they change.

### Individual Player Lookups
Your agent checks specific player availability upon request.

### Roster Filtering
Your agent generates lists of players based on their current role or status.

### Automated Status Updates
Your agent modifies player availability through simple text commands.

### Team Summaries
Your agent calculates total roster counts and status breakdowns instantly.

## Use Cases

### Game Day Readiness
Check the total number of Active players right before a game starts to ensure you have enough personnel.

### Injury Management
Move players to the Absent status when they report an injury to keep the roster accurate.

### Roster Depth Checks
Use the reserve list to identify which players are available to step in when an active player is unavailable.

### Attendance Tracking
Quickly identify all players marked as Absent to follow up on missed sessions.

## Benefits

- Eliminates manual roster updates by using natural language commands.
- Maintains roster integrity with three distinct, clear player statuses.
- Provides instant visibility into team availability through summary tools.
- Reduces administrative overhead for coaching staff.

## How It Works

You connect the MCP to your AI client and start managing your roster through conversation.

1. Connect your AI client to the Team Roster Count MCP via Vinkius.
2. Tell your agent to check a player's status or get a team summary.
3. Command the agent to update a player's status when availability changes.
4. Review the updated roster counts through the agent's responses.

## Frequently Asked Questions

**What statuses can I assign to players?**
You can assign players to three specific statuses: Active, Reserve, or Absent.

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

**How do I see a list of all players who are currently absent?**
You can ask your AI agent to list players by status, specifically requesting those who are marked as Absent.

**Do I need to host this myself?**
No, Vinkius hosts and manages the MCP for you. You just connect it to your client and it is ready to use.

**Can I update player info through my AI agent?**
Yes, you can use the update tool to change a player's status through your AI client's interface.

**How can I see the total number of players in a team?**
You can use the `get_roster_summary` tool to retrieve the total count along with the breakdown of active, reserve, and absent players.

**Can I change a player's status?**
Yes, use the `update_player_status` tool to change a player's status to Active, Reserve, or Absent.

**How do I find all players who are currently absent?**
You can use the `list_players_by_status` tool and set the status filter to 'Absent'.
