canonical: https://jentic.com/apis/nodots.com/nodots-backgammon # Nodots Backgammon API The Nodots Backgammon API runs backgammon games as a service. You create a game, roll the dice, make and confirm moves, offer and respond to the doubling cube, and let a robot opponent take its turn, all through REST calls. It also reads player profiles, game history, and per-game statistics such as performance ratings, and can import and export match records. It suits developers building backgammon apps, bots, or analysis tools without writing their own game engine. ## For AI agents Play backgammon through a hosted engine: create games, roll dice, make and confirm moves, handle the doubling cube, drive a robot opponent, and read player stats and game history. Authenticates with a Bearer JWT in the Authorization header. ## Scope Does not handle matchmaking, chat, or payments. Use for running backgammon games, moves, and the doubling cube and reading player stats and history only. ## Capabilities - Create a backgammon game and read its current state - Roll the dice and make, confirm, or undo moves in a game - Offer, accept, or decline the doubling cube - Have a robot opponent take its turn in a game - Read player profiles, game history, and per-game statistics ## Use cases ### Power a backgammon app without a game engine A developer building a backgammon app can delegate the rules to Nodots: the app creates a game, rolls the dice, and submits each move, and the API validates and tracks the board state. This avoids implementing move legality and cube logic from scratch. Through Jentic an agent discovers each operation by intent and calls it with the game id and move. Example prompt: Create a new backgammon game, roll the dice, and return the current board state and game id ### Play against a robot opponent An agent can run a full game against the built-in robot: it makes the human side's moves and asks the robot to take its turn, alternating until the game ends. This lets a solo player or an automated test play complete games. The doubling cube can be offered and answered along the way. Example prompt: In an existing game, make the current player's move and then have the robot take its turn ### Analyse player performance An analysis tool reads a player's game history and per-game statistics, such as performance ratings, to track how they are improving. It can pull the moves for a game and export match records for deeper study. This turns completed games into review material without a separate database. Example prompt: Retrieve the performance statistics for a given player id and return their rating ## Key endpoints | Method | Path | Description | | --- | --- | --- | | POST | `/games` | Create a new backgammon game | | GET | `/games/{gameId}` | Read the current state of a game | | POST | `/games/{gameId}/roll` | Roll the dice for the current turn | | POST | `/games/{gameId}/move` | Make a move in the game | | POST | `/games/{gameId}/robot-move` | Have the robot opponent take its turn | | GET | `/stats/users/{userId}` | Read a player's per-game statistics | ## Key resources - **Games** — Create games and read their current state - **Moves** — Roll dice, make and confirm moves, and drive the robot opponent - **Doubling cube** — Offer, accept, or decline the doubling cube - **Players and stats** — Read player profiles, game history, and per-game statistics ## Why Jentic - **Setup:** Wiring the Nodots Backgammon API by hand means obtaining an Auth0-issued JWT, setting the Bearer header, and formatting the create-game, roll, move, and cube calls against the versioned base URL yourself. Through Jentic you install once, import the Nodots Backgammon API from the API Directory, store the token once, and your agent calls it. - **Permission scoping:** The Nodots Backgammon API addresses each game by an id in the URL path, so you can scope the agent to a single game and the moves it needs: allow it to roll and move and leave player-data reads out of the allowed set unless you add them. - **Credential handling:** Your Nodots API token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'start a backgammon game' or 'make a move', and Jentic returns the matching Nodots operation with its input schema so the agent calls the right endpoint without reading the reference docs. ## Related APIs - **Lichess API** — A free online chess platform with a games API versus Nodots' backgammon engine. - **PandaScore API** — Esports match data and odds that can sit alongside a game engine in a gaming app. - **IGDB API** — A games metadata database for titles, genres, and artwork to enrich a gaming app. ## FAQ ### What authentication does the Nodots Backgammon API use? The Nodots Backgammon API authenticates with a Bearer token in the Authorization header, and the token is a JWT issued through Auth0. Through Jentic the token is stored encrypted by your own Jentic One instance and supplied to requests at execution time, so the agent never sees the raw value. ### Can I play a full backgammon game through the API? Yes. You create a game, roll the dice, make and confirm moves, and handle the doubling cube, and the API tracks and validates the board state at each step. You can also ask the built-in robot to take its turn, so an agent can run a complete game end to end. ### Does the Nodots Backgammon API include a robot opponent? Yes. A dedicated operation makes the robot take its turn in a game, so a solo player or an automated test can play complete games without a second human. The agent alternates between making the human side's moves and requesting the robot's move until the game ends. ### What are the rate limits for the Nodots Backgammon API? The OpenAPI spec does not declare rate limits for the Nodots Backgammon API. Apply conservative client-side throttling, back off on HTTP 429 responses, and check the Nodots API documentation for any current published limits. ### Can I limit what my agent is allowed to do with the Nodots Backgammon API? Yes. You choose which operations the agent may call, so it can be allowed to roll and move within a game while reading player data stays out of the allowed set unless you add it. Because each game is addressed by an id in the URL path, you can also keep the agent to a single game, and every call it makes is logged. ### Is there a Nodots Backgammon API MCP server? You don't need an MCP server to give your agent the Nodots Backgammon API. Jentic connects it directly from the API Directory: import it, store the token once, and your agent calls the game and move operations on demand without a separate server to run. ### How do I play a backgammon game through Jentic? Search Jentic for an intent like 'start a backgammon game' or 'make a move', which returns the matching Nodots operation with its input schema so the agent supplies the game id and move and reads the response. To run it on your own infrastructure, install Jentic One from its GitHub repo.