# Billiards Cut Angle Calculator AI Agent Connect

> Deterministic geometry engine for precision pool and billiards shot mechanics.

## Overview
- **Category:** sports
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_Uy1WlAkMzsiDGiI3TLKa5AKqEiqkcEFHEYLJqhYZ/ai-agent-connect
- **Tags:** billiards, pool, geometry, physics-engine, shot-mechanics

## Description

This MCP server provides a deterministic geometry engine for precision pool and billiards shot mechanics. It allows AI agents to calculate exact aiming points using ghost ball geometry, determine tangent lines for stun shots, and predict friction-induced throw deviation. Additionally, it uses the diamond system to predict cue ball rebound angles and exit points after hitting a rail, accounting for applied English. Use `calculate_impact_geometry` to find the ideal aiming position, `estimate_throw_deviation` to account for friction, and `predict_rail_rebound` to plan rail shots.

## Tools

### calculate_impact_geometry
Determines the precise aiming point and fundamental angles for a specific shot

### estimate_throw_deviation
Predicts how much friction will pull the object ball off its intended geometric path

### predict_rail_rebound
Uses the diamond system to predict the cue ball's path after hitting a cushion

## Prompt Examples

**Prompt:** 
```
Calculate the impact geometry for a shot where the cue ball is at (10, 10), the object ball is at (20, 20), and the pocket is at (30, 10), with a ball radius of 2.85.
```

**Response:** 
```
The ideal ghost ball position is at (15.94, 15.94) with a cut angle of 45.0 degrees and a tangent line angle of 45.0 degrees.
```

**Prompt:** 
```
What is the estimated throw deviation for a cut angle of 30 degrees with a spin intensity of 0.5?
```

**Response:** 
```
The estimated angular deviation caused by friction is 1.25 degrees.
```

**Prompt:** 
```
Predict the rail rebound for an entry angle of 45 degrees using 'right' spin with a strength of 0.8 and a diamond fraction of 0.5.
```

**Response:** 
```
The predicted exit angle is 52.3 degrees and the exit point is at (45.2, 12.8).
```

## Frequently Asked Questions

**How do I calculate the correct aiming point?**
You can use the `calculate_impact_geometry` tool. Provide the coordinates for the cue ball, object ball, and target pocket to receive the precise ghost ball position and cut angle.

**Can this tool predict how spin affects a rail rebound?**
Yes, the `predict_rail_rebound` tool uses the diamond system to calculate the exit angle and exit point, factoring in the type and strength of English applied.

**Does it account for friction-induced deviation?**
Yes, the `estimate_throw_deviation` tool predicts how much friction will pull the object ball off its geometric path based on the cut angle and spin intensity.