# Moddable.Games — AI Tool Server
# https://tools.moddable.games

> Moddable.Games provides open-source board game engines as AI-callable tools.
> 13 tools across two engines: chess variant analysis (70+ variants) and hex map generation (6 games).

## Endpoints

- MCP (SSE): https://tools.moddable.games/mcp
- MCP (message): POST https://tools.moddable.games/mcp/message
- REST API: POST https://tools.moddable.games/api/call
- Tool list: GET https://tools.moddable.games/api/tools
- OpenAPI spec: https://tools.moddable.games/openapi.json

## Tools

### chess_list_variants
List all available chess variants with their descriptions, board sizes, and rules.

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

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

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

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

### chess_get_opening_book
Look up opening book moves for a position. Returns known good continuations from the variant opening book.

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

### hex_list_games
List all available hex map games with their map types, layouts, sizes, and style options.

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

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

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

### hex_export_svg
Export a generated hex map as an SVG string for rendering or embedding.

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

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

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

## Prompts

### analyse_position
Analyse a chess position given in FEN notation. Identifies threats, material balance, and suggests best moves for the side to play.
Arguments: fen (required), variant

### build_variant
Design a new chess variant step by step. Guides through board size, piece types, win conditions, and special rules.
Arguments: theme (required)

### plan_hex_map
Plan a hex map layout for a board game. Determines grid size, terrain distribution, and resource placement based on player count and game type.
Arguments: players (required), game

## Resources

### Chess Variants Catalog
Complete list of all 70+ supported chess variants with group classifications
URI: tools://moddable-games/variants

### Tool Catalog
Full listing of all available tools with input schemas and descriptions
URI: tools://moddable-games/tools

### TI4 Faction List
All Twilight Imperium 4e factions (base + Prophecy of Kings expansion)
URI: tools://moddable-games/ti4-factions