# Sports Jersey Inventory Manager AI Agent Connect

> Sports Jersey Inventory Manager handles the math behind your team's equipment. It calculates exactly how many jerseys you need based on roster size, checks your current stock against player counts, and makes sure new orders won't exceed your storage capacity.

## Overview
- **Category:** inventory-management
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_lorLzsWiLfI3nvMIMnrCGJ70iFoNZLwQ1QKn1V54/ai-agent-connect
- **Tags:** sports, inventory, logistics, team-management, jersey-calculation

## Description

Managing equipment for sports organizations usually means messy spreadsheets and guessing how many spares you actually have. This MCP changes that by giving your AI client direct access to your inventory logic. Instead of manually counting every jersey, you can just tell your agent how many players are on the roster and let it handle the math. It looks at your current stock, compares it to your player needs, and tells you if you're short or overstocked. You can also use it to figure out if a large bulk order will actually fit in your existing storage space. It's a practical way to stop over-ordering gear or running out of jerseys right before a big game.

## Tools

### validate_order_feasibility
Use this to check if a new jersey order will actually fit within your maximum storage limits.

### calculate_team_scale_needs
This tool assigns a specific team category tier based on the total number of players.

### get_required_jersey_count
This tool calculates the total jersey count needed by factoring in player numbers and desired spare capacity.

### get_roster_inventory_summary
This tool compares your current jersey stock against your active player count to show you your standing.

## Prompt Examples

**Prompt:** 
```
How many jerseys do I need for a team of 25 players with 5 spares?
```

**Response:** 
```
You will need a total of 30 jerseys.
```

**Prompt:** 
```
I have 15 jerseys in stock and 20 players. Do I have enough?
```

**Response:** 
```
No, you have a shortage of 5 jerseys.
```

**Prompt:** 
```
What tier is a team with 150 players?
```

**Response:** 
```
A team with 150 players is classified as Professional.
```

## Capabilities

### Requirement Calculation
Your agent calculates total jersey needs including extra spares.

### Stock Auditing
The AI compares what you have in the closet to what the roster requires.

### Storage Validation
Your agent checks if new orders will exceed your physical storage limits.

### Tier Classification
The tool automatically categorizes teams into scale tiers based on player counts.

## Use Cases

### Pre-Season Ordering
Calculate exactly how many jerseys to order once the final roster is set.

### Storage Planning
Verify if a large shipment of new gear will fit in your current facility.

### Inventory Audits
Compare current stock levels against player counts to find missing items.

### Team Scaling
Automatically determine if a team falls into a specific organizational tier.

## Benefits

- Prevents over-ordering by checking storage capacity before you buy.
- Eliminates manual math for jersey counts and spare requirements.
- Provides instant visibility into jersey shortages relative to roster size.

## How It Works

Connect the MCP to your preferred AI client and start asking questions about your gear.

1. Connect the MCP to Claude, Cursor, or Windsurf via Vinkius.
2. Provide your current player count or roster details to your agent.
3. Ask the agent to calculate needs or check stock levels.
4. Receive direct answers about jersey counts, shortages, or storage limits.

## Frequently Asked Questions

**How does this MCP help with jersey ordering?**
It calculates the exact number of jerseys required by looking at your player count and how many spares you want to keep on hand.

**Can I check if I have enough jerseys for my players?**
Yes, you can ask your agent to summarize your inventory against your roster to see if you have a shortage.

**Will it tell me if my storage is full?**
Yes, the validate_order_feasibility tool checks if a requested order fits within your maximum storage capacity.

**Does it categorize teams by size?**
Yes, it uses the calculate_team_scale_needs tool to determine a team's category tier based on player count.

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

**How does the tool calculate the total number of jerseys needed?**
The `get_required_jersey_count` tool calculates the total by adding the player count to any requested spare capacity for backups.

**Can I check if I have enough jerseys for my current roster?**
Yes, you can use `get_roster_inventory_summary` to compare your current inventory against your player count to identify surpluses or shortages.

**How are team tiers determined?**
Team tiers like Youth, Amateur, or Professional are determined by the player count using the `calculate_team_scale_needs` tool.
