Reported issues for Moddable Games Tools

Pod holds 13 of 13 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to Moddable Games Tools.

Most discussed

Migrate MCP tools Worker into moddable-engine

Context

The MCP tools Worker (workers/mcp/) currently lives in moddable-website and imports from sibling repos (moddable-chess, moddable-hexmaps, moddable-rules) via relative paths that wrangler resolves at bundle time. This creates:

• Sync overhead — build scripts (build-oracles.mjs) that read from moddable-rules and produce JSON snapshots that duplicate source data
• Hardcoded game logic — oracle recipes, encounter builders, entity schemas all maintained in the website r

Read the thread · 2026-07-22 · open · outside contributor · 2 comments

Rules tools data quality: missing metadata, truncated content, broken UX

Problem

The 5 rules-related tools (rules_list_games, rules_get_game, rules_get_variant, rules_search, rules_random) have serious data quality issues discovered during manual Discord testing:

1. Missing metadata ("null players" everywhere)

• rules_list_games shows "null players" for 30+ games
• Root cause: games-sync.json only has metadata for ~10 Moddable-original games. The other 31 games in moddable-rules have players, duration, and tagline in their rulebook frontm

Read the thread · 2026-07-22 · open · outside contributor · 1 comment

Oracles tool page: narrative scene generator at /tools/oracles/

Summary

A new tools page at /tools/oracles/ that composes multiple oracle rolls into usable narrative seeds. Not a single-table roller — a scene generator that combines results across categories to produce contextual, ready-to-use prompts for solo RPG play and GM prep.

Consumes the MCP tools API (rules_search, plus new oracle-specific tools as needed).

Core Features

Scene Forge

Roll across multiple oracle categories simultaneously and compose results into a narrative seed.

Read the thread · 2026-07-20 · closed · outside contributor · 1 comment

Expose piece gallery via MCP tools + universal search

Context

moddable-chess now has a manifest-driven piece gallery with 89 sets / 2,598 SVGs across 18 game families. Each set has structured metadata in manifest.json:

{
  "id": "maurimo-celtic",
  "name": "Monge Celtic",
  "family": "chess",
  "author": "Maurizio Monge",
  "authorUrl": "https://github.com/maurimo",
  "source": "https://github.com/maurimo/chess-art",
  "license": "MIT",
  "licenseUrl": "https://opensource.org/licenses/MIT",
  "pieceCount": 12
}

A gallery index (

Read the thread · 2026-06-28 · closed · outside contributor · 1 comment

Chess tools page: consolidate into variant explorer + add API-powered tools

Context

The current chess tools page has 3 disconnected cards (Variant Picker, Rules Reference, Match Setup) that all operate on the same selected variant but feel disjointed. The page also doesn't leverage any of the MCP chess tools we have available.

Plan

1. Consolidate the top section into a single "Variant Explorer"

One unified card with:

• Variant selector at the top (the picker)
• Below: rules, board info, and play button as a flowing section (not separate cards)
• MCE embed

Read the thread · 2026-06-23 · closed · outside contributor · 1 comment

Smithery quality score: add MCP prompts and resources to Worker

Context

tools.moddable.games is listed on Smithery (mark-6qxj/moddable-games-tools). Currently at ~60% quality score after adding description, icon, and listing publicly.

Remaining score factors

To push toward 80-85%, add these to the MCP protocol handlers in workers/mcp/index.js:

1. Add MCP prompts — Named prompts with arguments (e.g. "analyse_game" prompt that suggests a workflow for analysing a chess position)
2. Add MCP resources — At least one resource URI (e.g. `tools:/

Read the thread · 2026-06-10 · closed · outside contributor · 1 comment

Expand site-native MCP tools: dice, TI4, Talisman, deck utilities

Context

tools.moddable.games now serves 15 tools (7 chess, 6 hexmaps, 2 site-native). The site-native tools (dice_roll, ti4_random_factions) are implemented directly in the Worker. More of the existing site tools could be exposed as MCP-callable functions.

Candidates from existing tools pages

Read the thread · 2026-06-10 · closed · outside contributor · 5 comments

Shared MCP server: unified AI tool interface for all engines

Summary

Create a shared MCP (Model Context Protocol) server at tools.moddable.games that exposes all Moddable engines as AI-callable tools. One server, all engines, zero duplication.

Architecture

tools.moddable.games/mcp          → SSE/HTTP MCP server (Cloudflare Worker)
tools.moddable.games/llms.txt     → Discovery file for non-MCP AI consumers
tools.moddable.games/openapi.json → REST fallback spec

Both engines run as stateless function calls inside a single Worker. No DOM d

Read the thread · 2026-06-10 · closed · outside contributor · 1 comment

Most recent

Add DNS-ADS TXT records for all domains

Context

Cloudflare's agent-readiness scanner checks for DNS-AID (DNS Agent Identifier Discovery) records using the SVCB record type under the _agents namespace (draft-mozleywilliams-dnsop-dnsaid).

Records to add

These are SVCB (type 64) records. All point to the same central MCP tools endpoint (hub-and-spoke):

Read the thread · 2026-07-23 · open · outside contributor · 0 comments

Migrate piece gallery to moddable-engine; add boards + tiles galleries

Current state

The MCP piece-gallery tools (piece_gallery_search, piece_gallery_get_set, piece_gallery_stats) import from moddable-chess/gallery-index.json (96 sets). This is stale.

moddable-engine has richer data

• Pieces: pieces/gallery-index.json — 115 sets, same schema, more complete
• Boards: boards/board-index.json — 333 board SVGs (every game family + variant + topology type)
• Tiles: tiles/tile-index.json — 7 hex tile sets with colour maps and terrain ty

Read the thread · 2026-07-22 · open · outside contributor · 0 comments

Developers API page: redesign with interactive tool tester

Context

The /developers/api/ page is currently the weakest in the developers section. It shows a connect command block and a flat grid of tool cards auto-rendered from mcp-tools.json. No interactivity, no live examples, no curl snippets.

The /developers/examples/ page was redesigned this session with live integration cards and build ideas — the API page should match that quality.

What it needs

• Interactive tool tester — pick a tool, fill in args, call it live and see the response

Read the thread · 2026-06-21 · closed · outside contributor · 1 comment

Integrate chess puzzle pool + SVG boards into MCP/Discord tools

Context

moddable-chess now has a complete puzzle pool (1,617 puzzles) exported to workers/mcp/puzzle-pool.json. The chess engine also has chess_render_svg for rendering any position as a self-contained SVG. This issue tracks integrating both into the MCP tools and Discord bot.

What's available from moddable-chess

Puzzle pool (puzzle-pool.json)

Format: Keyed by variant:type — e.g. standard:mate-in-1, atomic:detonate-in-1, codrus:sacrifice-your-king

Totals:

• 606

Read the thread · 2026-06-21 · closed · outside contributor · 1 comment

Puzzle pool: expand to 100+ standard + variant-specific puzzle generation

Context

The MCP tools Worker at tools.moddable.games serves puzzles from a pre-generated pool (to avoid exceeding Cloudflare Workers free tier CPU limits). Currently: 16 standard mate-in-1 puzzles.

What's needed

Standard puzzles (100-1000)

• Generate a large pool of standard mate-in-1 and mate-in-2 puzzles offline
• Include well-known public puzzles from classical chess history (Philidor, Morphy, etc.) — these are public domain
• Store in workers/mcp/puzzle-pool.json, deployed wit

Read the thread · 2026-06-10 · closed · outside contributor · 0 comments

The remaining reports are on the project's issue tracker.