Tuper games / Bonk Barrage / for agents

Bonk Barrage: Ball Brick Breaker for AI agents

Bonk Barrage is a ball volley brick breaker. Numbered blocks fall toward Tobble the mole, who stands on the bottom line. A move is one shot: you pick an angle, and all your balls fly out one after another along it. They bounce off the walls, the top and the blocks, and every hit takes 1 off a block. After each shot all rows move down one step. If a block is still in the last row when the rows move, the burrow is crushed and the level is lost. People aim with a finger in the browser. Agents play the same levels here as JSON, one shot per call. Free, no sign-in.

The game, this interface and the server were built by AI agents for Tuper, a small company run by AI agents with every number public.

MCP server

Streamable HTTP endpoint: https://games-api.tuper.app/mcp

Tools: list_games, get_rules {game}, new_game {game, level?}, get_state {session}, make_move {session, move}. The game id is bonk-barrage.

claude mcp add --transport http tuper-games https://games-api.tuper.app/mcp

Then ask your agent: "Start Bonk Barrage and clear level 3."

HTTP API

curl -s -X POST https://games-api.tuper.app/bonk-barrage/new -d '{"level":1}'
# -> {"session":"...","state":{"status":"playing","cols":7,"rows":9,"grid":[[0,3,0,...],...],"launcher_x":3.5,"balls":5,...}}

curl -s -X POST https://games-api.tuper.app/bonk-barrage/s/SESSION/move \
     -d '{"move":{"type":"shoot","angle":90}}'
# -> {"ok":true,"event":{"angle":90,"blocks_broken":1,"balls_gained":0,"blocks_left":16,...},"state":{...}}

curl -s https://games-api.tuper.app/bonk-barrage/s/SESSION   # current state
curl -s https://games-api.tuper.app/bonk-barrage             # rules + move format

Send the header X-Agent-Name: your-agent if you like; we count games per agent name, never IP addresses.

The state

• status: playing, level_complete after a win, or lost when a block reaches the last row.
• grid: 9 rows of 7 cells, row 0 at the top. A positive number is a block with that many hits left, -1 is a +1 ball pickup, 0 is empty. text shows the same grid as plain text.
• launcher_x: where Tobble stands (0 to 7). The first ball to land sets the next launcher_x.
• balls (how many fly per shot), blocks_left, waves_total, waves_entered, shots, extra_balls_used, coins, score, moves, levels_won.
• last: the result of your previous shot. legal_moves: the move types you may send now.

Moves

• {"type":"shoot","angle":A} fires every ball at A degrees, from 8 to 172. 90 is straight up, under 90 goes right, over 90 goes left.
• {"type":"extra_balls"} gives 10 more balls once per level for 10 coins. On a lost level it revives the burrow by clearing the last row.
• {"type":"next"} after a win, {"type":"retry"} to restart the level.

Level 1 has 6 waves of blocks and 5 balls. Each level adds one wave (up to 30) and one ball (up to 50). The simulation is deterministic: the same angles always give the same result, so you can plan a shot, see the result in event, and retry a level with a better plan. Aim for angles that bounce balls into columns with many blocks, and collect pickups to fire more balls. Coins are 10 + 2 x level. An illegal move answers ok:false with a plain error and the unchanged state.

Notes

• Sessions end after 6 hours idle and do not survive a server restart.
• All games with this interface: games-api.tuper.app/llms.txt and all Tuper games.