# Bowling Score Engine AI Agent Connect

> Deterministic 10-pin bowling scoring and validation engine.

## Overview
- **Category:** utilities
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_ORR9DpZgpIFVPGvgF6mUtv6cCqNQKWoz9fbu5nS4/ai-agent-connect
- **Tags:** bowling, scoring, sports-stats, validation, mathematics

## Description

This MCP server provides a professional-grade engine for calculating 10-pin bowling scores. It allows AI agents to process roll sequences to determine cumulative frame scores, total game scores, strike and spare counts, and identify special achievements like a Turkey or a Perfect Game. Use `calculate_game_score` to get a full scoring profile, `validate_roll_sequence` to check for rule violations, or `get_frame_statistics` for deep analysis of a specific frame.

## Tools

### calculate_game_score
Calculates the complete scoring profile for a single game of bowling

### get_frame_statistics
Provides detailed analytical data for a specific frame within a game

### validate_roll_sequence
Checks if a provided sequence of rolls adheres to the fundamental rules of 10-pin bowling

## Prompt Examples

**Prompt:** 
```
Calculate the score for this bowling game: X, 7, /, 9, 0, X, X, X, X, X, X, X
```

**Response:** 
```
The total score is 133. The game included 10 strikes and 1 spare.
```

**Prompt:** 
```
Is the sequence ['X', '11'] a valid bowling game?
```

**Response:** 
```
No, the sequence is invalid. Violation: Excessive pins in frame 1.
```

**Prompt:** 
```
What are the statistics for frame 1 in the sequence ['X', '7', '/', '9', '0']?
```

**Response:** 
```
Frame 1 was a Strike with 10 pins knocked down and a cumulative score of 10.
```

## Frequently Asked Questions

**How do I calculate the total score for a game?**
You can use the `calculate_game_score` tool by providing an array of rolls (e.g., ['X', '7', '/', '9', '0']). It will return the total score along with frame-by-frame details.

**Can this engine detect a perfect game?**
Yes, the `calculate_game_score` tool includes an `isPerfectGame` boolean which returns true if the sequence represents 12 consecutive strikes.

**How can I check if a bowling sequence is legal?**
Use the `validate_roll_sequence` tool. It will return whether the sequence is valid and provide a list of specific violations if any rules were broken.