Use the API
The API is free and read-only. There is no key and no sign-up. Every answer is JSON.
curl https://api.thebgdb.org/v1/search?q=azulOpenAPI description
The full, machine-readable description of every route, parameter and answer is published with each release at api.thebgdb.org/v1/openapi.json. Load it into any OpenAPI tool to browse the API or generate a client. It also covers accounts, photos and lists.
The same description is readable as a page: the API reference.
The main requests
| Request | Returns |
|---|---|
GET /v1/search?q=catan | Games whose name contains every word of q. Ignores case and accents; does not correct typos. q needs at least two characters. |
GET /v1/games/{id} | One game, by the id every game object carries: description, players, playing time, credits and photos. |
GET /v1/games?limit=50 | The catalog, a page at a time. Pass the nextCursor you received as cursor to get the next page. |
GET /v1/health | Whether the API is up. |
Connect an AI assistant (MCP)
Assistants that speak the Model Context Protocol can use the catalog directly. Add this server address to your assistant:
https://mcp.thebgdb.org/mcpIt needs no sign-in. To let an assistant see and edit your lists, use https://mcp.thebgdb.org/member instead: it asks you to sign in and approve first. An API token from your account page also works on the first address.
Limits
Without a token: 300 requests a minute per address. With an API token from your account page: 1,200 a minute, or 6,000 on the paid plan. Over the limit, the API answers 429; wait a minute and carry on. Answers are cached for up to five minutes, so a change can take that long to show.