# Buzz Bingo Agent Context

Last updated: 2026-06-04

## What Buzz Bingo Is

Buzz Bingo is a bingo-engine. It turns shared moments into bingo-style games: event watch parties, sports, culture, internet moments, private groups, creator communities, brand activations, and public live prediction games.

The brand is not one monolithic app. It is a family of bingo products tied together by the central hub at https://www.buzzbingo.xyz.

## Domain Roles

https://www.buzzbingo.xyz is the central hub. It owns the homepage, Bingo Generator, product overviews, Private Games entry page, Gift Cards in-development surfaces, hidden Brand Games demos, Creator Games prototype, and IRL Events prototype.

https://www.buzzbingo.fun is the app surface for Public Live Games and Private Games runtime routes. Public Live Games are off-chain-first live event bingo. Private Games are closed small-group games with creation, player, and host routes.

## Product Map

Bingo Generator is live on buzzbingo.xyz. The main route is /bingogenerator. Current featured generator topics include internet, sports, and event cards such as AI Wars 2026, MrBeast, Knucklebump, NBA Finals, FIFA World Cup, and America 250. Older event generators live in an archive drawer.

Public Live Games are beta on buzzbingo.fun. Current public live-game topics include NBA Finals 2026 and FIFA World Cup Games. Crypto Price Bingo is coming soon in the current public lobby. Eurovision 2026 and Champions League Final 2026 are archived live games.

Private Games are playable V1. The product entry page is https://www.buzzbingo.xyz/private-games. Creation and runtime routes are on buzzbingo.fun under /private/create and /private/:gameCode. Private Games are separate from Public Live Games and Creator Games.

Gift Cards are in development on buzzbingo.xyz. Demo and generator work exists, but payment, delivery, persistence, and final product mechanics are not ready.

Brand Games are hidden in-progress demos on buzzbingo.xyz. They should not be described as launched.

Creator Games are an early-access prototype, separate from Private Games.

IRL Events are a visual prototype. Organizer and live event operations are not built yet.

ViBingo Cards are a planned offline product, not a website route.

## Stale Or Legacy Signals

The following direct routes may exist for backwards compatibility but should not be presented as the current featured game list:

- /empirepredictionbingo
- /christmas
- /newyearseve
- /2026pandr

If an agent needs the current list, use /api/public/games or this file instead of old search snippets.

## Public JSON

Read-only public JSON endpoints:

- GET /api/public/site-summary
- GET /api/public/products
- GET /api/public/games
- GET /api/public/games/:id
- GET /api/public/live-state

These endpoints are intentionally public and do not include admin tokens, host tokens, private game secrets, Supabase internals, payment state, or player-sensitive data.

## Agent Gameplay Boundary

Public web access is read-only. Agents may inspect products, games, rules summaries, public statuses, and sandbox card-generation options through the MCP server. Agents may not mutate real live games, submit real cards, act as a real player, use admin controls, or access private game host secrets in v1.