MODDABLE.GAMES

Tools API

15 AI-callable tools for chess variant analysis, hex map generation, and board game utilities. Connect from any MCP client or call via REST.

claude mcp add --transport http moddable-tools https://tools.moddable.games/mcp

tools

engines

<10ms

response

cost

ENDPOINTS

Connect however you want

POST /mcp/messageMCP protocol (JSON-RPC)

GET /mcpMCP server-sent events (SSE)

POST /api/callREST API — {"tool": "name", "args": {...}}

GET /api/toolsList all tools with input schemas

GET /llms.txtAI-readable discovery file

GET /openapi.jsonOpenAPI 3.1 specification

QUICK START

curl -X POST https://tools.moddable.games/api/call \
  -H "Content-Type: application/json" \
  -d '{"tool": "chess_list_variants", "args": {"group": "Tactical"}}'

CHESS · 7 TOOLS

Variant analysis

chess_list_variantsList all available chess variants with their descriptions, board sizes, and rules.

chess_get_legal_movesGet all legal moves for the current position. Returns moves in algebraic notation with annotations (capture, promotion, castling, etc).

chess_analyze_positionEvaluate a chess position using the engine. Returns a score (centipawns from the side to move), best move, and the principal variation.

chess_validate_moveCheck whether a specific move is legal in the current position. Returns legal/illegal with explanation.

chess_make_movesPlay a sequence of moves from a position and return the resulting FEN, game status, and move list.

chess_get_opening_bookLook up opening book moves for a position. Returns known good continuations from the variant opening book.

chess_generate_puzzleGenerate a chess puzzle (mate-in-N or tactical sequence). Returns a FEN position and the solution moves.

HEXMAPS · 6 TOOLS

Map generation

hex_list_gamesList all available hex map games with their map types, layouts, sizes, and style options.

hex_generate_mapGenerate a hex map for a given game. Returns the full hex grid with terrain types, coordinates, and metadata.

hex_get_infoGet detailed information about a specific hex coordinate on a generated map: terrain type, neighbors, and distances to other hexes.

hex_compute_fovCompute field-of-view from a hex position: all hexes visible within a given range, respecting line-of-sight through the grid.

hex_export_svgExport a generated hex map as an SVG string for rendering or embedding.

hex_pathfindFind the shortest path between two hexes on a generated map using breadth-first search. Optionally specify impassable terrain types.

UTILITIES · 2 TOOLS

Board game utilities

dice_rollRoll dice using standard notation (e.g. "2d6+3", "4d8-1", "d20"). Supports any combination of dice, modifiers, and multiple pools.

ti4_random_factionsGenerate random faction assignments for a Twilight Imperium 4e game. Supports base game and Prophecy of Kings expansion.