Twin Tides Patience / for agents

Twin Tides Patience for AI agents

Twin Tides Patience is an open-information card puzzle: six columns of five cards, two tide piles, and a stock you can drop on either tide. People play it in the browser at tuper.app/games/twin-tides. Agents play the same rules here, as JSON: read the state, pick one of the legal moves, send it back. 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?, seed?}, get_state {session}, make_move {session, move}.

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

Then ask your agent: "Start a Twin Tides Patience game and clear deal 1."

HTTP API

curl -s -X POST https://games-api.tuper.app/twin-tides/new -d '{"level":1}'
# -> {"session":"...","state":{...,"legal_moves":[{"type":"play","col":0,"tide":"ebb"},...]}}

curl -s -X POST https://games-api.tuper.app/twin-tides/s/SESSION/move \
     -d '{"move":{"type":"draw","tide":"flow"}}'
# -> {"ok":true,"event":{...},"state":{...}}

curl -s https://games-api.tuper.app/twin-tides/s/SESSION   # current state
curl -s https://games-api.tuper.app/twin-tides             # 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, deal_complete (won; send {"type":"next"} for the next deal) or lost (no card fits and the stock is empty; send {"type":"retry"} to redeal the same deal).
• level (= deal number), score, moves, chain, cards_left, stock_left, stock_next (the one stock card you can see).
• columns: for each column its cards top to bottom, the free card (the last one) and which tides it fits. tides: the top card of ebb and flow, plus both piles.
• text: the layout as text. Cards are rank + suit (A 2..10 J Q K; S H D C).
• legal_moves: ready-made moves; send any one back as it is.

Moves

• {"type":"play","col":C,"tide":"ebb"|"flow"}: put the free card of column C on a tide when its rank is exactly one above or below the tide's top card (Ace low, King high, no wrap).
• {"type":"draw","tide":"ebb"|"flow"}: drop the next stock card on the tide you choose. This cannot be undone.

Every deal can be won, but you cannot see the stock beyond the next card, so choosing the tide for each draw is the puzzle. A wrong move returns "ok":false with a plain-English reason and the unchanged state. Score is 10 per card plus a chain bonus, and 20 per unused stock card when you win.

Notes

• Deal N is the same deal every time, and the same as classic deal N in the browser game. There is no daily deal and no undo here.
• Sessions end after 6 hours idle and do not survive a server restart.
• More games get the same interface: see games-api.tuper.app/llms.txt and all Tuper games.