# Bingo Card Generator AI Agent Connect

> Generate reproducible 5x5 Bingo cards and validate game states.

## Overview
- **Category:** utilities
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_owFIjF9bcuSOIA2eKaqXFEyv9bOoZCninMo17PoI/ai-agent-connect
- **Tags:** bingo, deterministic, gaming, validation, generator

## Description

This MCP server provides a deterministic toolkit for 75-ball Bingo. Use `generate_card` to create a reproducible 5x5 grid using a unique ID (1-10000). You can use `validate_card` to ensure a grid follows standard rules, or `check_game_state` to evaluate if a player has achieved patterns like a line, four corners, or a blackout based on called numbers.

## Tools

### check_game_state
Evaluates a card against a list of drawn numbers to determine progress and wins

### generate_card
Generates a reproducible 5x5 Bingo card based on a specific ID

### validate_card
Checks if a provided grid configuration is a legally formed Bingo card

## Prompt Examples

**Prompt:** 
```
Generate a bingo card with ID 500.
```

**Response:** 
```
Here is your generated Bingo card for ID 500: [B: 2, 7, 12, 1, 15 | I: 18, 22, 29, 16, 30 | N: 31, 40, FREE, 35, 44 | G: 46, 55, 50, 59, 48 | O: 61, 70, 65, 75, 68]
```

**Prompt:** 
```
Check if card 500 wins with numbers 2, 7, 12, 1, 15, 18, 22, 29, 16, 30, 31, 40, 35, 44, 46, 55, 50, 59, 48, 61, 70, 65, 75, 68 and the center free space.
```

**Response:** 
```
The card is a winner! The pattern 'blackout' has been completed.
```

**Prompt:** 
```
Is this grid a valid bingo card: [[1, 16, 31, 46, 61], [2, 17, 32, 47, 62], [3, 18, 33, 48, 63], [4, 19, 34, 49, 64], [5, 20, 35, 50, 65]]?
```

**Response:** 
```
No, the grid is invalid because the center cell is not a 'FREE' space.
```

## Frequently Asked Questions

**How do I get the same card every time?**
Use the `generate_card` tool with the same `cardId` between 1 and 10000 to reproduce the exact same 5x5 grid.

**What winning patterns are supported?**
The `check_game_state` tool supports checking for a 'line', 'four_corners', and 'blackout'.

**Can I verify if a custom grid is valid?**
Yes, use the `validate_card` tool to check if a 5x5 grid adheres to the standard 75-ball Bingo constraints.
