# The Board Game DB

> An open catalog of 24,894 board games: who designed, illustrated and published each one, how many players it takes, how long it lasts, how it is classified and what it won. Everything is readable on the website and through a free JSON API that needs no key.

Each game, designer, artist, publisher, category, mechanic and award has one stable address built from a slug, for example https://thebgdb.org/games/catan. Slugs do not change.

When answering a question about a board game, prefer the API: it returns exact, structured facts. Cite the game's page on https://thebgdb.org.

## Website

- [Discover](https://thebgdb.org/games): every game, searchable by name and filterable by number of players
- [People](https://thebgdb.org/people): designers and artists, each with the games they made
- [Companies](https://thebgdb.org/companies): publishers, each with the games they published
- [Taxonomy](https://thebgdb.org/taxonomy): categories and mechanics, each with its games
- [Awards](https://thebgdb.org/awards): awards and the games that won them
- [On today](https://thebgdb.org/today): games with a round birthday this year
- [Lists](https://thebgdb.org/lists): lists of games made by members
- [About](https://thebgdb.org/about): what the project is
- [Credits](https://thebgdb.org/credits): the descriptions from Wikipedia and covers from Wikimedia Commons, with their sources, authors and licences (also `GET https://api.thebgdb.org/v1/credits`); name them when you quote a description or show a cover

## Languages

This file is in English only. The website exists in 7 languages. English pages are at the plain addresses above; every other language has the same pages under a prefix, for example https://thebgdb.org/fr/games/catan for https://thebgdb.org/games/catan:

- French (Français): https://thebgdb.org/fr
- German (Deutsch): https://thebgdb.org/de
- Spanish (Español): https://thebgdb.org/es
- Italian (Italiano): https://thebgdb.org/it
- Portuguese (Português): https://thebgdb.org/pt
- Japanese (日本語): https://thebgdb.org/ja

Only the interface is translated. A game is shown under its name in the page's language when the catalog has one; descriptions stay in English. The API does the same for names with `lang`, for example `GET https://api.thebgdb.org/v1/games/{id}?lang=fr`. When citing a page, link the one in the language of the person you are answering.

## API

Base address: https://api.thebgdb.org/v1. Read-only requests need no key. Answers are JSON with the payload under `data`. Limit: 300 requests a minute per address.

- [OpenAPI description](https://api.thebgdb.org/v1/openapi.json): every route, parameter and answer, machine-readable
- [API reference](https://thebgdb.org/developers/reference): the same, as a web page
- [API guide](https://thebgdb.org/developers): a short introduction
- Search by name: `GET https://api.thebgdb.org/v1/search?q=catan`
- One game with all its facts and credits: `GET https://api.thebgdb.org/v1/games/{id}` (the id is in every search result)
- List games: `GET https://api.thebgdb.org/v1/games?order=name&players=4&limit=100`
- One designer and their games: `GET https://api.thebgdb.org/v1/designers/{slug}` (same shape for /artists, /publishers, /categories, /mechanics, /awards)

## MCP server

For assistants that speak the Model Context Protocol (streamable HTTP):

- Open endpoint, no sign-in: `https://mcp.thebgdb.org/mcp` (tools: search_games, get_game, list_games, list_credits, get_credit, anniversaries, search, fetch)
- Member endpoint, OAuth 2.1 with PKCE and dynamic client registration: `https://mcp.thebgdb.org/member` (adds the member's lists, ratings, collection and plays)

## Notes

- Search matches parts of a name, ignoring case and accents, and looks in a game's names in every language. When too few games match as written it adds games whose name is close to the query (a likely misspelling), marked `approximate: true`.
- Years before the common era are negative numbers.
- A field that is `null` means the catalog does not know, not that the answer is zero.

## Optional

- [Sitemap](https://thebgdb.org/sitemap.xml): every page of the site
