# 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](/mcp/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](https://github.com/Moddable-Games/moddable-website/issues/139) · 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](https://github.com/Moddable-Games/moddable-website/issues/136) · 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](https://github.com/Moddable-Games/moddable-website/issues/135) · 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`:

```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](https://github.com/Moddable-Games/moddable-website/issues/127) · 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](https://github.com/Moddable-Games/moddable-website/issues/123) · 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](https://github.com/Moddable-Games/moddable-website/issues/104) · 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

| Tool | Source page | Complexity | Value |
|------|------------|------------|-------|
| `ti4_random_objectives` | /tools/ti/ | Low | Draw public/secret objectives for a round |
| `ti4_agenda_vote`

[Read the thread](https://github.com/Moddable-Games/moddable-website/issues/103) · 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](https://github.com/Moddable-Games/moddable-website/issues/101) · 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):

| Type | Name | Priority | Target | Parameters |
|---|---|---|---|---|
| SVCB | `_mcp._agents` | 1 | `tools.moddable.games.` | `alpn="mcp" port=443` |
| SVCB | `_mcp._agents.to

[Read the thread](https://github.com/Moddable-Games/moddable-website/issues/140) · 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](https://github.com/Moddable-Games/moddable-website/issues/137) · 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](https://github.com/Moddable-Games/moddable-website/issues/120) · 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](https://github.com/Moddable-Games/moddable-website/issues/119) · 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](https://github.com/Moddable-Games/moddable-website/issues/102) · 2026-06-10 · closed · outside contributor · 0 comments

The remaining reports are on [the project's issue tracker](https://github.com/Moddable-Games/moddable-website/issues).