# Free-Throw Percentage Calculator AI Agent Connect

> Free-Throw Percentage Calculator MCP gives your AI client the ability to process basketball shooting data. It handles everything from calculating specific accuracy percentages to validating shot statistics against official rules. You can also pull career summaries or categorize players into specific skill tiers like Elite or Average based on their performance metrics.

## Overview
- **Category:** statistics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_1VF1Y0JxxZ1JgvoBhhp9lfFnRfV59giG0gc55kqH/ai-agent-connect
- **Tags:** basketball, stats, accuracy, sports-analytics, shooting

## Description

You can use this MCP to turn messy shooting logs into clean, professional basketball analytics. Instead of manually calculating percentages or checking if a player's stats make sense, you just hand the data to your AI agent. It handles the math and the logic for you. 

If you're looking at a player's career, you can get a high-level overview of their performance in seconds. You can also determine where a player stands by checking their efficiency tier. It's built to ensure the numbers you're working with are actually valid according to basketball rules, so you don't waste time analyzing impossible stats. Whether you're evaluating a single game or a decade of performance, this MCP provides the specific calculations you need to grade shooting skill accurately.

## Tools

### get_career_summary
This tool provides a high-level overview of a player's free-throw performance. It aggregates total attempts and makes into a single summary.

### get_efficiency_tier
This tool categorizes a player's performance into specific skill tiers. It identifies if a shooter falls into categories like Elite or Average.

### get_shooting_accuracy
This tool calculates the exact free-throw percentage for any given set of shooting statistics.

### validate_shot_stats
This tool checks if a set of shooting statistics is logically valid. It ensures the numbers follow standard basketball rules.

## Prompt Examples

**Prompt:** 
```
What is the free-throw percentage for 80 made shots out of 100 attempts?
```

**Response:** 
```
The free-throw percentage is 80%.
```

**Prompt:** 
```
Is a player with 95 made shots and 100 attempts considered Elite?
```

**Response:** 
```
Yes, with a 95% success rate, the player is categorized as Elite.
```

**Prompt:** 
```
Give me a career summary for 500 made shots and 600 attempts.
```

**Response:** 
```
The career summary shows 600 total attempts, 500 total made, and a success rate of 83.33%.
```

## Capabilities

### Accuracy Calculation
Your agent uses this to find the exact percentage of shots made.

### Skill Tiering
The AI uses this to label players as Elite or Average based on their stats.

### Data Validation
Your client uses this to confirm that shooting stats are logically possible.

### Career Summaries
The agent uses this to condense long-term shooting history into a quick overview.

## Use Cases

### Player Scouting
Input a prospect's shooting numbers to see if they hit the Elite tier.

### Performance Auditing
Use the validation tool to ensure a data source hasn't provided impossible shooting ratios.

### Historical Research
Generate career summaries for legendary players to compare their efficiency over time.

### Game Prep
Quickly check the accuracy of an opponent's free-throw shooting before a matchup.

## Benefits

- Eliminates manual percentage calculations.
- Flags impossible or illogical shooting statistics automatically.
- Standardizes player skill levels into recognizable tiers.
- Condenses massive career datasets into readable summaries.

## How It Works

Connect your client to Vinkius and start sending stats to your agent.

1. Connect your MCP-compatible client to Vinkius.
2. Paste your raw basketball shooting data into your AI chat.
3. Ask your agent to calculate accuracy or check a skill tier.
4. The agent calls the specific tool to process the numbers.
5. Receive the calculated results or summaries immediately.

## Frequently Asked Questions

**How do I use this MCP with Claude?**
You connect your Claude client to the Vinkius platform. Once connected, you can simply ask Claude to perform basketball calculations using the tools provided by this MCP.

**Can this MCP tell me if a player is an elite shooter?**
Yes. The get_efficiency_tier tool categorizes players into skill tiers like Elite or Average based on their shooting stats.

**Does it check if my data is correct?**
Yes. The validate_shot_stats tool checks if the shooting statistics you provide are logically valid according to basketball rules.

**What kind of basketball stats can I input?**
You can input made shots and total attempts to get accuracy, career summaries, or skill tier classifications.

**Do I need to host this myself?**
No. Vinkius hosts and manages the MCP for you. You just connect your client and start using the tools.

**How do I calculate a player's accuracy?**
You can use the `get_shooting_accuracy` tool by providing the number of made shots and the total attempted shots.

**What are the skill tiers?**
Players are categorized into Elite (90%+), Good (75-89%), Average (50-74%), or Poor (below 50%) using `get_efficiency_tier`.

**Can I validate if my stats are correct?**
Yes, use `validate_shot_stats` to ensure that the number of made shots does not exceed the number of attempts and that no values are negative.