# Bridge Scoring Engine AI Agent Connect

> Deterministic duplicate bridge scoring for contract results, trick points, bonuses, and penalties.

## Overview
- **Category:** utilities
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_C0hRmEu2rksS2sspBgAdrhVxL6KZR6uw2pvq0f6R/ai-agent-connect
- **Tags:** bridge, scoring, duplicate-bridge, card-games, deterministic

## Description

This MCP server provides a deterministic scoring engine for duplicate bridge. It calculates precise contract results, trick scores based on suit tiers, fixed bonuses for games and slams, and penalties for undertricks. Use `calculate_contract_result` to check if a contract was made, `calculate_trick_points` for suit-based scoring, `calculate_bonuses` for game/slam rewards, and `calculate_penalties` for defender scores when a contract fails.

## Tools

### calculate_bonuses
Calculates fixed bonuses for making a Game or a Slam

### calculate_contract_result
Determines if the contract was successful or failed and by how many tricks

### calculate_penalties
Calculates the penalty score awarded to the defenders when a contract is not made

### calculate_trick_points
Calculates the score derived solely from the tricks won

## Prompt Examples

**Prompt:** 
```
Was the 4♠ contract made if 10 tricks were taken?
```

**Response:** 
```
Yes, the contract was made with 1 extra trick.
```

**Prompt:** 
```
Calculate the trick points for a 3NT contract where 9 tricks were taken.
```

**Response:** 
```
The trick score is 120 points.
```

**Prompt:** 
```
What is the penalty for a 3♥ contract being down 1 trick when not vulnerable?
```

**Response:** 
```
The penalty is 50 points.
```

## Frequently Asked Questions

**How does the engine handle doubled or redoubled contracts?**
The engine applies multipliers to trick scores and bonuses for doubled contracts, and higher multipliers for redoubled contracts, as well as increasing penalties for undertricks.

**Can I calculate penalties for undertricks?**
Yes, you can use the `calculate_penalties` tool to determine the score awarded to defenders based on the number of undertricks and vulnerability.

**What suits are supported?**
The engine supports clubs, diamonds, hearts, spades, and no trump (nt).