Skip to main content
Glama

GameForge MCP (gameforge-mcp)

The 100% Open-Source Game Studio & AI Asset Consistency Gateway (Model Context Protocol) — v2.0.0

License: MIT Version: 2.0.0 Node.js >= 22.5 Zero Dependencies MCP Tools: 24 Adversarial QA: 10.0/10

Most AI game-art workflows collapse the moment you try to build a playable 2D or 2.5D game: armor mutates across 8 directional angles, weapon lengths drift frame-to-frame, camera pitch angles clash (35.264° true isometric vs 26.565° 2:1 pixel-dimetric), semi-transparent AI alpha fringes ruin dark cave backgrounds, feet skate across tiles, and swappable avatar equipment clips through bodies.

GameForge MCP (v2.0.0) turns any MCP-capable coding agent (Google Antigravity, Claude Code, Claude Desktop, Cursor, Windsurf, Roo Code, Zed) into a deterministic Technical Art Director, Native Binary PNG/Normal-Map Atlas Compiler, and Multi-Engine Pipeline Builder—bridging Blender 4.x, ComfyUI (Split FLUX / Merged SDXL / ControlNet / IP-Adapter / BiRefNet), TRELLIS.2 / Hunyuan3D 2.1 / TripoSR, UniRig, LibreSprite / Aseprite, LDtk / Material Maker, Godot 4, Unity, and Unreal Engine 5.

  • 0 External NPM Dependencies — Built directly on Node.js 22+ native node:sqlite, node:zlib, node:net, and node:http. Includes a custom RFC-2083 binary PNG decoder/encoder, CIE L*a*b* perceptual palette quantizer, and tangent-space normal-map stitcher with zero node-gyp build failures.

  • 100% Open-Source Stack — MIT licensed, built exclusively around open-weights models and open DCC bridges with zero paid cloud credit walls.


Live v2.0.0 Output Showcase (Generated Out-of-the-Box in <1s)

Every asset in ./examples/valkyrie-25d-showcase/ was compiled in a single tool call via gameforge_build_complete_character_slice + gameforge_generate_tileset_spec using zero external npm packages:

8-Dir × 6-Frame 2.5D Albedo Atlas (0px Foot Jitter)

Paired Camera-Space Tangent Normal Atlas ([0..1] RGB)

Valkyrie 2.5D Albedo Atlas

Valkyrie 2.5D Normal Map Atlas

100% CIE L*a*b* Palette Locked • 0 Semi-Transparent Halo Pixels • 1px Chromatic Outline

Dynamic 2D/2.5D Torchlight Ready (Godot CanvasTexture / Unity URP _NormalMap / UE5 Paper2D)

Canonical 47-Tile Blob Auto-Tile Bitmask Template (sanctuary_blob47_template_mask.png)

47-Tile Blob Auto-Tile Mask


Related MCP server: game-agent-factory

What's New in v2.0.0

  1. Native RFC-2083 Binary PNG Codec, CIELAB Quantizer & Dual Atlas Stitcher (src/codec/png-codec.mjs) — Pure JavaScript PNG decoder (supporting all 5 PNG scanline filters including Paeth) and node:zlib encoder. Strips AI alpha halos (alpha < threshold → 0, >= threshold → 255), snaps every pixel to your locked .gpl palette in perceptual CIE L*a*b* space (with optional 4×4 Bayer dithering), injects 1px chromatic outlines, locks every frame's lowest opaque pixel to an exact foot-pivot baseline (0px vertical jitter), and stitches paired Albedo + Tangent Normal-Map sprite sheets.

  2. Self-Adapting ComfyUI Live Introspector (src/wings/comfy-wing.mjs) — Queries live GET /object_info on your ComfyUI server, supports both split FLUX (UNETLoader + DualCLIPLoader + FluxGuidance + VAELoader) and merged single-file checkpoints (CheckpointLoaderSimple), auto-selects whichever background-removal node you have installed (BiRefNet_Hugo, BiRefNet, RMBG, ImageRemoveBackground+), and cleanly falls back to loop-free stock LoadImage submission when VHS_LoadImagesPath is absent.

  3. 20-Bone Game Humanoid Rig, Mixamo Retargeter & 6 Procedural Clips (src/wings/blender-wing.mjs) — Builds a complete 20-bone game skeleton (root, hips, DEF-spine chain, shoulder/upper_arm/forearm/DEF-hand.L/R, thigh/shin/foot.L/R), retargets external Mixamo .fbx animations (MIXAMO_MAP), generates 6 procedural biomechanical Blender Actions (idle, walk, run, slash_combo_1, cast_spell, death), renders Freestyle 1px lineart passes, and bakes remapped [0..1] Camera-Space Tangent Normal Maps.

  4. Zero-Placeholder Pre-Sliced Godot 4, Unity C#, and Unreal 5 Exporters + 10-Point Pixel QA Gate (src/wings/engine-wing.mjs) — Godot .tres pre-slices every Cols × Rows SubResource("AtlasTexture_...") Rect2 region and wires CanvasTexture diffuse + normal maps; Unity C# AssetPostprocessor slices SpriteMetaData[] + binds URP 2D _NormalMap while StudioBuilder.cs wires ObjectReferenceKeyframe[] sprite curves into .anim clips + saves .prefab; UE5 Python imports Albedo + Normal PNGs into directional PaperFlipbook assets; and gameforge_audit_asset_consistency verifies binary pixel compliance across 10 deterministic checks.

  5. One-Shot Vertical Slice Compiler & Standalone HTML5 Torchlight Studio (src/wings/preview-wing.mjs) — gameforge_build_complete_character_slice executes Vault initialization, Style Bible lock, Character registration, Paper-Doll Z-matrix computation, Combat frame-data, Procedural 2.5D + Normal + Gear synthesis, Binary PNG atlas stitching, Godot/Unity/Unreal exports, Interactive HTML5 Torchlight Studio generation, and the 10-Point Pixel QA Gate in a single call.


How GameForge Solves Multi-Angle & Frame-to-Frame Consistency

Instead of asking a 2D diffusion model to guess poses across 8 directions and 12 animation frames, GameForge enforces "3D Structural Truth + 2D Style Lock + Binary Pixel Verification":

[1. SQLite Style & Scale Vault]
    Locks Camera Pitch (26.565° / 30° / 35.264° / 38° / 0°), PPU, Hue-Shifted .gpl Palette & Safe Denoise Bounds
           │
           ▼
[2. Self-Adapting Canonical 4-View Turnaround (ComfyUI Split FLUX / SDXL + BiRefNet)]
    Locks Front / Right / Back / 3-Quarter Orthographic Identity on Neutral #808080 Matte
           │
           ▼
[3. Open-Source 3D Mesh + 20-Bone Rigging (TRELLIS.2 / Hunyuan3D / TripoSR -> UniRig / Blender 20-Bone + Mixamo)]
    Normalizes exact standing height in meters, plants feet at Z=0, parents Paper-Doll Bone Sockets + 6 Clips
           │
           ▼
[4. Deterministic Blender 4.x Orthographic Multi-Pass Baker]
    Renders 8/16 Directions × N Frames: Beauty + Depth + Freestyle Lineart + [0..1] Tangent Normal + Socket JSON
           │
           ▼
[5. Controlled ComfyUI Style Pass + Native RFC-2083 Binary PNG & CIELAB Atlas Compiler]
    ControlNet (Depth 0.78 + Lineart 0.68) + IP-Adapter (0.60) + Clamped Denoise -> Halo Strip + 0px Foot Lock
           │
           ▼
[6. Pre-Sliced Multi-Engine Exporters + HTML5 2.5D Torchlight Studio + 10-Point Pixel QA Gate]
    • Godot 4.x (Pre-sliced Rect2 SpriteFrames .tres, Normal-Lit CanvasTexture, .tscn, GDScript Controller)
    • Unity (C# SpriteMetaData[] Slicer, _NormalMap Secondary Texture, ObjectReferenceKeyframe[] .anim + .prefab)
    • Unreal Engine 5 (Python Albedo + Normal Import, Directional PaperFlipbook Builder, Ortho SpringArm)

7 Built-In Studio Camera & Genre Presets

Preset ID

Inspired By

Camera Pitch

Directions

Tile Grid

Core Technique

ragnarok_25d_dimetric

Ragnarok Online

30.0° Ortho

8 (45°)

128×64

3D World + 8-dir layered Paper-Doll sprites with per-angle Z-order swaps

tos_25d_ortho3d

Tree of Savior

38.0° Ortho

8 / 360°

256×128

Live rigged 3D low/mid-poly meshes with hand-painted unlit/toon + inverted-hull outlines

diablo_25d_isometric

Diablo II: Resurrected

26.565° (atan(0.5))

16 (22.5°)

128×64 (2:1)

Exact 2:1 pixel-dimetric 16-angle pre-rendered sprites + contact shadows + normal maps

true_isometric_tactics

FF Tactics / Tactics Ogre

35.264° (atan(1/√2))

4 (90°)

64×32

True CAD isometric grid elevation tactics

hd2d_diorama

Octopath Traveler

28.0° Hybrid

8 (45°)

32×32

3D PBR tilt-shift diorama world + point-filtered pixel billboards lit by 3D lights

deadcells_3d_to_2d

Dead Cells

0.0° Side Ortho

2 (L/R)

32×32

Blender filter_size=0.01px zero-AA render + tangent-space Normal Maps for dynamic 2D lights

pixel_platformer_2d

Celeste / Hollow Knight

0.0° Side Ortho

2 (L/R)

32×32

Crisp 2D sprites + coyote-time/jump-buffer physics + 47-tile Blob auto-tiles


Quickstart & Installation

Requires Node.js >= 22.5.0 (uses built-in node:sqlite and node:zlib).

git clone https://github.com/Andrew012410/gameforge-mcp.git
cd gameforge-mcp

# Run the built-in open-source ecosystem doctor
node ./bin/gameforge-mcp.mjs --doctor

# Run the full 24-tool adversarial integration & binary pixel QA suite
npm test

Add to MCP Client (mcp_config.json / claude_desktop_config.json / .cursor/mcp.json)

{
  "mcpServers": {
    "gameforge-mcp": {
      "command": "node",
      "args": ["--no-warnings", "/ABSOLUTE/PATH/TO/gameforge-mcp/bin/gameforge-mcp.mjs"],
      "env": {
        "COMFYUI_URL": "http://127.0.0.1:8188",
        "BLENDER_HOST": "127.0.0.1",
        "BLENDER_PORT": "9876"
      }
    }
  }
}

The 24 Studio Tools

Wing A — SQLite Style Vault, Scale Trigonometry & Paper-Doll Math (src/wings/vault-wing.mjs)

  1. gameforge_init_project — Locks camera projection, pitch, PPU, tile diamond ratio, sun vector, and asset folders.

  2. gameforge_lock_style_bible — Generates hue-shifted 5-step color ramps, .gpl GIMP/LibreSprite palettes, and safe ComfyUI denoise bounds.

  3. gameforge_register_character — Computes foreshortened orthographic pixel height (height_m × cos(pitch) × PPU), deterministic seed, and bone sockets.

  4. gameforge_compute_paperdoll_zorder — Solves 8/16-direction Z-priority draw order for modular gear (body, head, hair, weapon_r, offhand_l, cape_wings_back).

  5. gameforge_define_combat_framedata — Stores animation FPS, startup/active/recovery combat windows, hitstop ms, and AABB hitboxes.

Wing B — Self-Adapting ComfyUI Turnaround, Style Lock & FluxGym LoRA (src/wings/comfy-wing.mjs)

  1. gameforge_introspect_comfyui — Queries live ComfyUI GET /object_info to detect split FLUX (UNETLoader), checkpoints, ControlNet, IP-Adapter, BiRefNet/RMBG, and VHS batch nodes.

  2. gameforge_generate_turnaround_workflow — Builds/submits split-FLUX or merged-checkpoint + BiRefNet 4-view orthographic turnaround ComfyUI API graphs.

  3. gameforge_generate_consistent_sprites_workflow — Multi-pass ControlNet (Depth + Lineart) + IP-Adapter + clamped denoise + BiRefNet sprite workflow (with loop-free stock LoadImage fallback).

  4. gameforge_generate_lora_dataset_plan — Generates FluxGym / Kohya .toml configs and captioned manifests for local character/world Micro-LoRAs.

Wing C — Open-Source 3D (TRELLIS.2 / Hunyuan3D / TripoSR), 20-Bone Rigging & Ortho Baker (src/wings/blender-wing.mjs)

  1. gameforge_generate_3d_from_sheet — Self-hosted Python runners for TRELLIS.2, Hunyuan3D 2.1, and MIT TripoSR + UniRig follow-up.

  2. gameforge_blender_rig_and_sockets — Generates/executes Blender 4.x bpy scripts for metric scaling, 20-bone game armature binding, Mixamo .fbx retargeting, 6 procedural animation clips, Paper-Doll Empty sockets, and Tree of Savior inverted-hull outlines.

  3. gameforge_blender_ortho_turntable_bake — Renders 8/16-direction Beauty, Depth, Freestyle 1px Lineart, [0..1] Camera-Space Tangent Normal Map, and projected sockets_per_frame.json pixel coordinates.

Wing D — Native Binary PNG Codec, CIELAB Quantizer & LibreSprite Cleanup (src/wings/sprite-wing.mjs)

  1. gameforge_synthesize_procedural_frames — Pure-JS 3D oriented-capsule 2.5D character, tangent normal-map, and modular Paper-Doll gear frame synthesizer for instant zero-GPU vertical slices and pipeline testing.

  2. gameforge_compile_sprite_atlas — Native RFC-2083 binary PNG decoder/encoder that strips semi-transparent alpha fringes, quantizes to .gpl palettes in CIE L*a*b*, injects 1px chromatic outlines, locks 0px foot-pivot jitter, and stitches paired Albedo + Normal-Map sprite sheets.

  3. gameforge_libresprite_cleanup_script — Lua CLI batch script + native pure-Node fallback (run_native_fallback) for alpha cleanup and palette snapping.

Wing E — Worlds, 47-Tile Auto-Tiles & Procedural PBR (src/wings/world-wing.mjs)

  1. gameforge_generate_tileset_spec — Computes canonical 47-tile Blob & 16-tile Wang bitmasks, renders a pixel-exact .png bitmask template (render_template_png), and exports LDtk JSON + Material Maker PBR recipes.

Wing F — Pre-Sliced Multi-Engine Exporters, 10-Point Pixel QA Gate & Studio Codex (src/wings/engine-wing.mjs)

  1. gameforge_export_godot_package — Exports Godot 4 .tscn, pre-sliced Cols × Rows AtlasTexture SpriteFrames .tres, Normal-Lit CanvasTexture, and 2D/2.5D GDScript controllers.

  2. gameforge_export_unity_package — Exports Unity C# AssetPostprocessor (SpriteMetaData[] slicer + _NormalMap binding), ObjectReferenceKeyframe[] .anim + 8-way BlendTree + .prefab builder, and runtime Y-Sort/Hitstop scripts.

  3. gameforge_export_unreal_package — Exports Unreal Engine 5 Python scripts importing Albedo + Normal PNGs, generating directional PaperFlipbook assets, and configuring Orthographic SpringArm cameras.

  4. gameforge_audit_asset_consistency — 10-Point Technical Art & Binary Pixel QA Gate verifying camera math, denoise bounds, scale ratio, foot-pivot jitter (0px), binary PNG palette compliance, 0 semi-transparent fringe pixels, normal-map parity, Paper-Doll Z-matrix, and combat frame-data (0–100).

  5. gameforge_discover_ecosystem — Live probe for BlenderMCP socket, Blender CLI, ComfyUI, TRELLIS/UniRig, Godot 4, LibreSprite, and Ollama.

  6. gameforge_query_codex — Instant search across the built-in Technical Art & Game Engine Studio Codex.

Wing G — Interactive 2.5D Torchlight Studio & One-Shot Vertical Slice Compiler (src/wings/preview-wing.mjs)

  1. gameforge_generate_interactive_preview — Builds a self-contained HTML5 2.5D Normal-Lit Torchlight & Paper-Doll Inspection Studio with embedded base64 atlases, real-time N·L point-light shader math, modular gear toggles, and foot-pivot crosshair overlay.

  2. gameforge_build_complete_character_slice — Compiles an entire 2.5D character vertical slice end-to-end (Vault → Style Bible → Character → Paper-Doll Z-Matrix → Combat Frame-Data → Albedo + Normal + Gear Atlases → Godot/Unity/Unreal Exports → HTML5 Torchlight Studio → 10-Point QA Gate) in one tool call.


License

MIT © GameForge Open-Source Contributors.

Available Tools

24 tools
gameforge_audit_asset_consistencyC

Run the ruthless 10-Point Pixel-Verified Technical Art QA Gate: inspects Vault trigonometry, Style Bible denoise bounds, cos(pitch) scale math, .gpl palette, Paper-Doll Z-matrix, AND binary-decodes the stitched Albedo & Tangent Normal PNG atlases (verifying exact dimensions, zero semi-transparent AI halo pixels, (128,128,255) neutral normals, pre-sliced engine clips, and HTML5 preview).

NameRequiredDescriptionDefault
clip_nameNoClip to pixel-verify (defaults to first character animation or 'walk')
project_idYes
character_idNo

TDQS

C2.7/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It never says whether the gate is read-only or writes/clips output, whether it raises on failure versus returning a report, how long/expensive binary decoding is, or how the 10 points are reported. Enumerating the checks adds real context, but the operation's side effects and result contract are undisclosed.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

One front-loaded sentence that leads with the verb and the gate name before the check list. Every clause maps to a concrete verification, though the unbroken chain of jargon makes it a wall of text rather than scannable structure.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no annotations, no output schema, and two undocumented parameters, the description leaves the agent without the result contract (pass/fail payload? per-check findings?) or the meaning of the scope selectors. For a multi-stage QA gate this is materially incomplete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is only 33%: clip_name is documented as defaulting to the first animation or 'walk', but project_id and character_id have no schema descriptions at all. The tool description mentions none of the three parameters, so the two most important identifiers are entirely unexplained in both places.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource: 'Run the 10-Point Pixel-Verified Technical Art QA Gate' that 'inspects' and 'binary-decodes' atlases. It is clearly an audit/verification tool, distinguishable from generation and export siblings (e.g. gameforge_compile_sprite_atlas, gameforge_export_unity_package). The dense jargon ('Paper-Doll Z-matrix', 'Style Bible denoise bounds') adds flavor but the core action is legible.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to run it, what must exist first, or which sibling to use instead. An agent cannot tell whether this should run before export, after atlas compilation, or per-clip, nor what to do on failure. The only implied usage is 'run it on a project', which is not a routing rule.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

gameforge_blender_ortho_turntable_bakeB

Generate (and optionally run in Blender 4.x) the 8/16-Direction Orthographic Multi-Pass Baker (bpy): activates the requested Action clip (idle, walk, run, slash_combo_1, cast_spell, death), renders Beauty RGBA, Normalized Depth, Freestyle 1px Lineart, Camera-Space Tangent Normal Map (R=+X, G=+Y, B=+Z), and sockets_per_frame.json.

NameRequiredDescriptionDefault
clip_nameNoAction clip to activate & bake (default 'walk')
frame_endNo
project_idYes
frame_startNo
character_idYes
execute_in_blenderNo
pixel_crisp_aa_offNo

TDQS

B3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden; it does disclose the produced artifacts and that execution requires Blender 4.x `bpy`. It omits key behavioral facts for a render/bake job: where files land, disk writes and overwrite behavior, runtime cost, and whether the tool is safe to re-run.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single dense sentence that front-loads the action and then enumerates outputs, with no filler sentences. It is jargon-heavy with backticked identifiers, but every clause carries information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

No output schema and no annotations, so the description must stand alone; naming the emitted files compensates for the missing output schema. However, for a 7-parameter bake job it leaves frame-range semantics, AA toggle behavior, and return/status reporting entirely unexplained.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is only 14%, so the description must compensate — it partially does by listing the six valid clip names (schema only says default 'walk') and explaining `execute_in_blender`. But `frame_start`, `frame_end`, `pixel_crisp_aa_off`, `project_id`, and `character_id` remain undefined anywhere, leaving most of the 7 parameters opaque.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and artifact — generate an 8/16-direction orthographic multi-pass baker — and enumerates the exact render passes produced (Beauty RGBA, depth, lineart, tangent normal, socket JSON). It is clearly distinct from rigging/export siblings, though it never explicitly names a sibling to route away from.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no when-to-use guidance: nothing says whether this replaces or follows `gameforge_generate_turnaround_workflow`, `gameforge_blender_rig_and_sockets`, or `gameforge_synthesize_procedural_frames`. The parenthetical '(and optionally run in Blender 4.x)' hints at a dry-run mode but never states the condition for choosing it.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

gameforge_blender_rig_and_socketsB

Generate (and optionally run in Blender 4.x) a complete 19-Bone Game Humanoid Rig + Paper-Doll Socket + Animation Builder (bpy): normalizes metric height, binds all 19 torso/limb bones, retargets external Mixamo/BVH .fbx clips if provided, AND auto-generates 6 procedural biomechanical animation Actions (idle, walk, run, slash_combo_1, cast_spell, death) so static 3D meshes animate immediately!

NameRequiredDescriptionDefault
project_idYes
character_idYes
execute_in_blenderNo
external_mixamo_fbx_pathNoOptional external Mixamo / UniRig animated .fbx or .glb to retarget onto the 19-bone rig
generate_mannequin_if_mesh_missingNo

TDQS

B3.3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full behavioral burden. It does disclose real side effects — metric height normalization (mutates the mesh), bone binding, optional retargeting, and six generated Actions — but says nothing about whether existing rigs are overwritten, where outputs are written, or what happens if Blender is unavailable. The Blender-execution optionality is at least surfaced.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The content is relevant and front-loaded, but it is delivered as one dense run-on sentence packed with parentheticals, backticks, and an exclamation mark. Splitting the generation, retargeting, and animation-capability clauses would make it scannable.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a complex, five-parameter, no-annotation, no-output-schema Blender pipeline tool, the description covers the what but not the operational contract: output artifacts, overwrite behavior, Blender availability requirements, and one wholly undocumented parameter remain unaddressed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is only 20% (just external_mixamo_fbx_path), so the description must compensate. It partially does — Mixamo/BVH retargeting, optional in-Blender execution, and height normalization map to three of the five parameters — but generate_mannequin_if_mesh_missing is never mentioned anywhere, leaving a genuine gap.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a highly specific verb-and-resource pair: generate a 19-bone humanoid rig, paper-doll sockets, and a procedural animation builder using `bpy` in Blender 4.x. That specificity makes it easy to tell apart from siblings like gameforge_generate_3d_from_sheet or gameforge_blender_ortho_turntable_bake, though it never explicitly names those alternatives.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is only implied through phrases like 'so static 3D meshes animate immediately' and 'retargets external Mixamo/BVH .fbx clips if provided'. There is no explicit statement of when to pick this over the mesh-generation or turntable-bake siblings, nor any when-not guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

gameforge_build_complete_character_sliceC

One-Command End-to-End Studio Compiler: runs the entire 12-stage GameForge pipeline (Project Lock -> Style Bible + .gpl -> Character Scale -> Paper-Doll Z-Matrix -> Combat Frame-Data -> ComfyUI Self-Adapting Workflows -> 20-Bone Animated Blender Rig + Baker -> Native PNG + Normal Atlas Stitching -> 47-Tile Mask -> Godot 4 + Unity C# + UE5 Pre-Sliced Packages -> Interactive HTML5 Torchlight Studio -> 10-Point Pixel Audit = 100/100)!

NameRequiredDescriptionDefault
titleYes
clip_nameNo
accent_hexNo
project_idYes
primary_hexNo
character_idYes
display_nameNoAlias for character_name
genre_presetYes
height_metersNo
secondary_hexNo
visual_promptNo
workspace_dirYes
character_nameNo
art_direction_summaryNo

TDQS

C2.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations, so the description carries the full burden. It does disclose genuinely useful behavior: the ordered stage list tells the agent this writes many artifacts (rig, atlas, tilesets, Godot/Unity/UE5 packages, HTML5 studio) into workspace_dir and ends with an audit. But it says nothing about runtime, re-runnability, failure/partial-output behavior, or what happens to pre-existing outputs.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The lead phrase 'One-Command End-to-End Studio Compiler' is front-loaded and useful, but the 12-stage parenthetical chained with arrows plus the '= 100/100!' exclamation is marketing padding. It is one long run-on sentence that mixes the tool's purpose with output inventory.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 14-parameter, side-effect-heavy orchestrator with no annotations and no output schema, the description should cover prerequisites, artifact locations, and key parameter meanings. It instead delivers a stage list and a score claim, leaving the agent unable to construct a valid call or anticipate results.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

14 parameters with only 7% schema description coverage, and the description gives zero parameter-level meaning: genre_preset, the three hex colors, height_meters, visual_prompt, clip_name, and the character_name/display_name alias are all undocumented. Mentions of 'Style Bible' and 'Character Scale' only faintly hint at art_direction/height fields, far short of compensating for the coverage gap.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific action and resource: runs the full 12-stage GameForge pipeline from project lock through engine exports and a pixel audit. That makes its role as the orchestrator over the individual stage siblings (gameforge_lock_style_bible, gameforge_compile_sprite_atlas, gameforge_export_godot_package, etc.) inferable, though it never explicitly says 'this is the composite of those tools'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No statement of when to run the full pipeline vs. the individual stage tools, no prerequisites (does a project/character already need to exist?), and no warnings about cost or duration. The only guidance is the implicit 'one command = everything', which an agent cannot use to choose between this and the 20+ granular siblings.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

gameforge_compile_sprite_atlasB

Decode loose PNG frames natively in Node.js (zero external CLI required!), strip semi-transparent AI alpha halos, optionally quantize colors in perceptual CIE Lab* space to the Project Style Bible .gpl palette, auto-align lowest foot pixels to the locked Foot Pivot, and stitch real <char>_<clip>_atlas.png + <char>_<clip>_normal_atlas.png + Paper-Doll overlay atlases + <char>_<clip>_atlas.json!

NameRequiredDescriptionDefault
clip_nameYes
frames_dirNo
project_idYes
character_idYes
auto_align_foot_pivotNoEliminate frame-to-frame vertical floating (default true)
bayer_dither_strengthNoOptional 4x4 Bayer pixel dither 0..32 (default 0)
quantize_to_style_paletteNoSnap colors in CIELAB space to Style Bible (default true)

TDQS

B3.1/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations at all, the description carries the full burden, and it does disclose meaningful behavior: native Node PNG decoding (no external CLI), destructive-ish pixel rewriting (alpha halo stripping), CIELAB quantization to a `.gpl` palette defaulting on, and the exact set of files written. It omits overwrite behavior for existing atlases, what happens when the palette or Foot Pivot is missing, and any failure/validation modes — gaps that matter for a multi-file write operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

It is a single information-dense run-on sentence that buries the primary action (stitching the atlas) at the end behind decoding and halo-stripping detail. The exclamation marks and marketing phrasing ('zero external CLI required!', trailing '!') waste space on selling rather than selecting the tool, though the core clauses are not padded with repetition.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description usefully enumerates the concrete output artifacts, which partly substitutes for the missing output schema, and it covers the three main processing stages. For a 7-parameter, multi-file-write tool with no annotations and no output schema, however, it should also state prerequisites, input expectations for `frames_dir`, and side effects on pre-existing atlas files.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is only 43% (3 of 7 params documented), so the description must compensate. It does add real meaning for `quantize_to_style_palette` (CIELAB, .gpl Style Bible source) and `auto_align_foot_pivot` (locked Foot Pivot), and implies `frames_dir`, but leaves `bayer_dither_strength`, `clip_name`, `project_id`, and `character_id` entirely unexplained beyond their names.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb chain and resource — decode PNG frames, align, and stitch `<char>_<clip>_atlas.png`, `_normal_atlas.png`, overlay atlases, and `.json`. An agent can tell this compiles a sprite atlas from loose frames, distinct from siblings like `gameforge_synthesize_procedural_frames` or `gameforge_build_complete_character_slice`, though it never explicitly contrasts itself with them.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It explains what the pipeline does step-by-step but gives no when-to-use guidance, no prerequisites (e.g., must the Style Bible be locked first, must `frames_dir` already contain renders?), and no mention of when to prefer a sibling such as `gameforge_build_complete_character_slice`.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

gameforge_compute_paperdoll_zorderB

Solve 2.5D multi-angle modular equipment layering (Ragnarok Online / Diablo Paper-Doll system). Outputs exact per-angle Z-index draw priority for Body, Head, Hair, Top/Mid Headgear, Right Weapon, Left Shield, and Back Wings/Cape across 8 or 16 directions, and writes paperdoll_zmatrix.json.

NameRequiredDescriptionDefault
directionsNoDefaults to project's direction count
project_idYes
character_idYes

TDQS

B3.3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden, and it does disclose a meaningful side effect: it writes paperdoll_zmatrix.json. However, it omits whether the file is overwritten, where it is written, what permissions or project state are required, and whether the Z-matrix is also returned.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with the core operation and then the output, with no filler. It is dense but every clause conveys relevant information, though the long enumeration of body parts is slightly heavy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a moderate-complexity computation tool with no output schema and no annotations, the description explains what is produced (per-angle Z priorities plus a JSON file) but not the return value shape or error/overwrite behavior. It is adequate but not fully complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 33%: only 'directions' is documented (and the description's '8 or 16 directions' merely echoes the enum). The description adds nothing about project_id or character_id semantics, so it fails to compensate for the low coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Solve ... layering') and a clearly named resource ('per-angle Z-index draw priority' for named body parts) and states that it writes paperdoll_zmatrix.json. No sibling tool overlaps this operation, so an agent can identify it unambiguously.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description never says when to call this versus other pipeline steps, nor what prerequisites (project_id/character_id) must be set up first. Usage is only inferable from the domain phrasing about paper-doll systems; there are no exclusions or alternative-routing guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

gameforge_define_combat_framedataC

Define deterministic animation & action-combat frame data (FPS, total frames, startup/active/recovery windows, hitstop freeze-frames in ms, and normalized AABB hitboxes) for crisp platformer or ARPG combat.

NameRequiredDescriptionDefault
fpsYesPlayback frames per second (e.g. 12 for crisp sprite anims, 24 for fluid)
loopingNo
hitboxesNoActive hitbox rectangles relative to character foot pivot in pixels
clip_nameYese.g. 'idle', 'run', 'slash_combo_1', 'dash', 'cast_holy', 'hitstun', 'death'
hitstop_msNoImpact freeze-frame duration in milliseconds (e.g. 65)
project_idYes
character_idYes
total_framesYes
active_framesNoFrames where weapon/skill hitbox deals damage
startup_framesNoWind-up telegraph frames before hitbox activates
recovery_framesNoFollow-through frames after active window

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It implies a persistence/mutation operation ('define') but never states whether data is created or overwritten, whether frames must be consistent with total_frames, what validation applies, or what is returned.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single front-loaded sentence with no filler; the action verb comes first and the field list earns its place. It is dense with parentheticals but still readable.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For an 11-parameter write-style tool with no annotations and no output schema, the description covers what the data represents but omits lifecycle behavior (create vs. update, validation, tie to character_id/project_id) that an agent needs before invoking it.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 64%, and the description restates most of those documented fields (fps, total_frames, startup/active/recovery, hitstop ms, AABB hitboxes) without adding syntax beyond the schema. Undocumented parameters such as looping, damage_multiplier, and knockback_px_per_sec get no compensating explanation.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Specific verb ('Define') plus a precise resource ('animation & action-combat frame data') with an enumerated field list. No sibling tool touches combat frame data, so it is implicitly distinguished from the rig/atlas/export tools, though no sibling is named.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description never says when to call this versus alternatives, nor what precedes it (e.g., after register_character or sprite generation), nor whether it can be called repeatedly. Usage is only inferable from the phrase 'for crisp platformer or ARPG combat'.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

gameforge_discover_ecosystemA

Live probe of your local & LAN open-source game development ecosystem (BlenderMCP socket, Blender CLI, ComfyUI, TRELLIS/Hunyuan3D/UniRig, Godot 4, LibreSprite/Aseprite, Ollama).

NameRequiredDescriptionDefault

No parameters

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. 'Live probe' usefully signals active checking (not cached config) and that LAN endpoints may be contacted, which hints at latency/availability dependence. But it says nothing about behavior when a tool is missing (error vs. reported absence), timeouts, or whether probing is side-effect free.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single front-loaded sentence with the verb and scope first and the enumerated targets after; nothing is redundant. The parenthetical list is long but each entry carries real disambiguating information, so it largely earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

There is no output schema and no annotations, so the description is the only source of truth about what comes back. It does not indicate the result shape (e.g. per-tool availability/version/path), how unavailable tools are represented, or how expensive the probe is — gaps that matter for a tool whose entire purpose is producing a status report.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool takes zero parameters, so there is no parameter semantics to explain and the baseline of 4 applies. The description correctly avoids inventing parameter claims that the empty schema would contradict.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific action (live probe / discovery) and enumerates exactly what is being discovered: BlenderMCP socket, Blender CLI, ComfyUI, TRELLIS/Hunyuan3D/UniRig, Godot 4, LibreSprite/Aseprite, Ollama. The parenthetical list makes it distinguishable from the narrower sibling gameforge_introspect_comfyui, though it never explicitly says 'this is the broad version of X'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is only implied: an agent can infer it should run this to learn what local tooling exists before choosing a pipeline tool. There is no explicit when-to-use/when-not, no statement that it is a read-only prerequisite step, and no pointer to gameforge_introspect_comfyui as the narrower alternative.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

gameforge_export_godot_packageB

Export a 100% ready-to-play Godot 4.x character package with ZERO empty placeholders: pre-slices every AtlasTexture Rect2(x, y, w, h) across all 8/16 directions & clips inside .tres, wires Diffuse + Tangent Normal Map into CanvasTexture, builds the Y-Sorted .tscn scene with Paper-Doll sockets, and writes the GDScript controller.

NameRequiredDescriptionDefault
project_idYes
character_idYes

TDQS

B3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden, and it does disclose the substantive behavior: it writes multiple file types (.tres, .tscn, .gd) and materializes textures and sockets. However, it doesn't say where files land, whether an existing package is overwritten, what happens if assets are missing, or whether the operation is reversible — all critical for an unannotated write tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single front-loaded sentence that spends its length on concrete, differentiating detail rather than restating the name. The '100% ready-to-play' / 'ZERO empty placeholders' capitalization is promotional padding, but it is brief and conveys an actual guarantee about output completeness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a multi-artifact generation tool with no annotations and no output schema, the description does establish what is produced, but omits destination paths, return value, preconditions, and failure modes. An agent knows what it gets but not enough to call it safely or to know when to call it in a pipeline.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% for two required parameters, so the description must compensate and it says nothing about project_id or character_id. Their names are self-evident, but no format, source (where to obtain the IDs), or validation semantics are added.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Specific verb (Export) plus a precisely scoped resource (a Godot 4.x character package), with the internal artifacts enumerated: .tres atlas slicing, CanvasTexture wiring, .tscn scene, GDScript controller. The 'Godot 4.x' qualifier implicitly distinguishes it from gameforge_export_unity_package and gameforge_export_unreal_package, but it never names those siblings to make the routing explicit.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no 'use when' clause, no prerequisite stated (e.g. that a character must already be registered or a slice built), and no ordering guidance relative to gameforge_build_complete_character_slice or gameforge_compile_sprite_atlas. The agent must infer the export stage entirely from the tool name and the sibling list.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

gameforge_export_unity_packageC

Export a zero-manual-drag Unity C# package: AssetPostprocessor auto-slices the entire cols x rows sprite grid (SpriteMetaData[] with exact Foot Pivot) + binds URP 2D _NormalMap, while StudioBuilder.cs programmatically generates .anim ObjectReferenceKeyframe[] sprite curves, wires the 8-way BlendTree, and saves a complete .prefab!

NameRequiredDescriptionDefault
project_idYes
character_idYes

TDQS

C2.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must carry the full behavioral burden. It describes the generated scripts and artifacts in detail, but does not state whether it overwrites existing files, what permissions or project state are required, where the package is written, or what the tool returns.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single front-loaded sentence with useful technical detail, but it is dense and includes promotional phrasing ('zero-manual-drag', an exclamation mark) that adds no operational value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no annotations, no output schema, and two undocumented parameters, the description covers only the generated artifact pipeline. It omits critical call context: required inputs, preconditions, side effects, and return behavior.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, and the description never mentions project_id or character_id. It provides no meaning, format, or scoping guidance for either required parameter, leaving the agent to infer from names alone.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource ('Export a ... Unity C# package') and details the generated artifacts, making the tool's output scope clear. It implicitly distinguishes itself from gameforge_export_unreal_package and gameforge_export_godot_package by engine, but does not explicitly call out the difference.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no explicit guidance on when to choose this over the Unreal or Godot exporters, nor any stated prerequisites such as an open Unity project or valid character setup. Usage is only implied by the word 'Unity'.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

gameforge_export_unreal_packageB

Export a complete Unreal Engine 5 Python (unreal) importer & Paper2D/PaperZD builder: imports Albedo + Normal PNG atlases, slices every (row, col) cell into PaperSprite assets with custom foot pivot, assembles directional PaperFlipbook clips, and spawns the locked Orthographic CameraActor.

NameRequiredDescriptionDefault
project_idYes
character_idYes

TDQS

B3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full burden; it does disclose the pipeline actions (imports atlases, slices cells, assembles flipbooks, spawns camera), which gives real behavioral insight. However, it omits key traits for an export that writes assets into a UE project: whether assets are overwritten, whether a running Unreal editor/plugin is required, and idempotency/side effects.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single front-loaded sentence opening with the action and platform, then elaborating outputs. No filler; every clause describes a produced asset. It is dense but every phrase earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description explains the pipeline's outputs but, with no output schema and no annotations, leaves gaps a caller needs: preconditions (source assets, editor availability), what a successful return looks like, and the role of the two required inputs. Adequate for a producer tool but noticeably short of complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% for both required params, and the description does not mention project_id or character_id at all, so it fails to compensate. The agent learns nothing about what these identifiers reference or how they select the source atlases.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb+resource (Export ... Unreal Engine 5 ... importer & Paper2D/PaperZD builder) and enumerates the concrete outputs (PaperSprite, PaperFlipbook, CameraActor). The mention of 'Unreal Engine 5' implicitly distinguishes it from the Unity and Godot export siblings, so an agent can route to it, though it never names those alternatives.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no explicit when-to-use or when-not-to-use guidance and no reference to the Unity/Godot export siblings as alternatives. The required project_id/character_id are not framed as prerequisites. The agent must infer timing from the name alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

gameforge_generate_3d_from_sheetC

Generate a self-hosted 100% open-source Image-to-3D pipeline script & job spec (supporting TRELLIS.2 MIT, Hunyuan3D 2.1, and TripoSR MIT low-VRAM fallback) to convert a locked 2D turnaround sheet into a clean manifold .glb mesh.

NameRequiredDescriptionDefault
project_idYes
character_idYes
target_facesNo
open_model_backendNo

TDQS

C2.9/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the burden of behavioral disclosure. It usefully reveals that the tool produces a self-hosted open-source pipeline script and job spec rather than directly executing the mesh conversion, and it names supported backends including a low-VRAM fallback, but it omits side effects, file write locations, permissions, and execution constraints.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single dense sentence with the core purpose front-loaded. The parenthetical backend list is long but informative and avoids unnecessary filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 4-parameter generation tool with no annotations, no output schema, and 0% schema description coverage, the description is too thin. It states the high-level output but leaves parameter semantics, prerequisites, and operational behavior largely unexplained.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate, but it explains only the backend choices in general terms and does not clarify project_id, character_id, or target_faces. The backend names and license notes add some meaning beyond the enum, but most parameters remain undocumented in both schema and description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description gives a specific verb (generate), resource (pipeline script and job spec), and domain (Image-to-3D from a locked turnaround sheet into a .glb mesh). It is clear what the tool produces, though it does not explicitly distinguish itself from related siblings such as gameforge_generate_turnaround_workflow or gameforge_blender_ortho_turntable_bake.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no explicit guidance on when to use this tool versus alternatives, nor on prerequisites such as whether the turnaround sheet must already be locked or whether style-bible locking is required first. The 'locked 2D turnaround sheet' phrase implies an input condition, but the description does not state sequencing or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

gameforge_generate_consistent_sprites_workflowC

Build (and optionally execute frame-by-frame or batch on ComfyUI) a self-adapting Sprite Consistency workflow combining Blender's Depth + Lineart orthographic passes + Turnaround IP-Adapter + clamped Denoise + dynamic Alpha Matting (zero VHS node lock-in!).

NameRequiredDescriptionDefault
clip_nameYes
project_idYes
character_idYes
denoise_strengthNo
workflow_profileNo
submit_to_comfyuiNo

TDQS

C2.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must carry the full behavioral burden. It mentions optional ComfyUI execution and avoiding VHS node lock-in, but does not disclose side effects, required services, permissions, execution behavior, or what the tool returns.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single long, jargon-heavy sentence that is not front-loaded with the core action. Terms like 'zero VHS node lock-in' and stacked pipeline names obscure rather than clarify the tool's role.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

This is a complex workflow-generation tool with 6 undocumented parameters, no annotations, and no output schema. The description gives a high-level technical summary but omits the information an agent needs to invoke it correctly, especially parameter meanings and execution side effects.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must explain all 6 parameters. It only indirectly hints at submit_to_comfyui and denoise_strength via phrases like 'optionally execute ... on ComfyUI' and 'clamped Denoise'; the required project_id, character_id, and clip_name are not addressed at all.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific action (build a Sprite Consistency workflow) and mentions optional execution on ComfyUI, so the general purpose is inferable. However, it is buried in dense jargon and does not clearly distinguish this tool from siblings such as gameforge_generate_turnaround_workflow or gameforge_synthesize_procedural_frames.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It notes that the workflow can be built and optionally executed frame-by-frame or in batch, but gives no guidance on when to choose this tool over related siblings. No prerequisites or exclusions are stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

gameforge_generate_interactive_previewB

Compile a standalone, zero-dependency HTML5 2.5D Studio Inspector (<char>_preview_studio.html) embedding the stitched Albedo Atlas, Tangent Normal-Map Atlas, Paper-Doll Weapon & Cape Atlases, Socket Coordinates, and Hitboxes—featuring a live 60fps per-pixel mouse-cursor Torchlight Normal Shader, 8/16-dir turntable, Paper-Doll Z-order swaps, and Hitstop tester!

NameRequiredDescriptionDefault
clip_nameNoClip to embed (default 'walk')
project_idYes
character_idYes

TDQS

B3.2/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the burden alone. It thoroughly describes the generated file's runtime features (60fps shader, turntable, z-order swaps, hitstop tester), which is useful behavioral context. However, it omits side effects like where the file is written, whether existing files are overwritten, and what prior state is required, leaving gaps for a file-generating mutation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The definition is front-loaded with the verb and artifact, which is good. But the single long sentence is packed with marketing-style feature jargon ('Torchlight Normal Shader', '8/16-dir turntable') that, while informative, is dense and could be structured into clearer prerequisite/behavior clauses.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description is rich about the generated artifact and its embedded content, which covers the output side reasonably well since no output schema exists. It is incomplete about prerequisites (e.g., atlas/Socket/Hitbox data must exist), file-write behavior, and the roles of the required IDs, which an agent needs to invoke this correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 33% (only clip_name is documented). The description does not explain project_id or character_id at all, aside from a passing `<char>` hint in the filename template. It fails to compensate for the low coverage, adding no meaningful parameter guidance beyond what the schema already shows.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb ('Compile') and a named artifact ('standalone, zero-dependency HTML5 2.5D Studio Inspector') with the exact output filename pattern. This is clearly distinct from sibling tools like gameforge_compile_sprite_atlas or the export packages, so an agent can identify it without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit when-to-use, when-not-to-use, or alternatives are named. The phrase 'embedding the stitched ... Atlases' implies a prerequisite (atlases must already exist), but this dependency is never stated as a condition for calling the tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

gameforge_generate_lora_dataset_planC

Generate an open-source FluxGym / Kohya_ss character or world-style Micro-LoRA training configuration (.toml) and auto-captioned dataset manifest.

NameRequiredDescriptionDefault
project_idYes
network_dimNo
character_idNo
trigger_tokenYes
max_train_stepsNo

TDQS

C2.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden. It implies file generation but does not say where files are written, whether existing artifacts are overwritten, what inputs/state are required, or whether the operation is costly. 'open-source FluxGym / Kohya_ss' hints at external tooling assumptions but no operational behavior is disclosed.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single dense sentence with the artifacts front-loaded and no filler. Slightly over-packed, but every clause earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

No output schema, no annotations, and zero parameter documentation for a 5-parameter generation tool. The description never says what the manifest contains, how many entries it will have, or what the caller must supply for the job to succeed, so an agent cannot reliably invoke it correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% and the description documents no parameters at all. Five parameters — trigger_token, character_id, network_dim, max_train_steps, project_id — are entirely opaque; an agent must guess that trigger_token is the LoRA activation word and how network_dim/max_train_steps interact with the generated .toml.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb ('Generate') and concrete artifacts (a FluxGym/Kohya_ss Micro-LoRA .toml config plus an auto-captioned dataset manifest), and distinguishes character vs world-style variants. It doesn't name any sibling tool, but the output artifacts make it clearly distinct from exports, workflows, and rigging tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No indication of when to use this versus alternatives, no prerequisites (e.g. whether the character must first be registered or the style bible locked), and no guidance on choosing the character vs world-style mode. The agent must infer all of this.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

gameforge_generate_tileset_specB

Generate deterministic 2D / 2.5D environment tilesets: computes canonical 47-tile Blob or 16-tile Wang bitmask coordinates, renders a real pixel-exact .png Auto-Tile / 2:1 Isometric Diamond ControlNet guide mask on disk, and writes LDtk JSON + Material Maker PBR recipes.

NameRequiredDescriptionDefault
project_idYes
tileset_idYes
autotile_modeNo
biome_descriptionYes

TDQS

B3.3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must carry behavior, and it does disclose that this is a write operation producing multiple on-disk artifacts (PNG mask, LDtk JSON, PBR recipes) and that output is deterministic. However, it omits critical traits: where files are written, whether existing tileset_id artifacts are overwritten, and whether the operation requires a locked style bible or initialized project.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single dense sentence that front-loads the verb and resource before listing outputs; every clause adds distinct information. It is a run-on, but that is a minor style cost rather than wasted content.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 4-parameter generative tool with no output schema and no annotations, the description explains the artifacts produced but leaves parameter meaning, output file locations, and prerequisites unresolved. It is enough to understand what the tool makes, not enough to invoke it confidently the first time.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% across 4 parameters, so the description must compensate, yet project_id, tileset_id, and biome_description are never explained. Only the autotile_mode enum is lightly implied by the mode names in prose, leaving most parameter meaning unstated.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific verb and resource ('Generate deterministic 2D / 2.5D environment tilesets') and enumerates the concrete outputs it produces: canonical 47-tile Blob or 16-tile Wang bitmask coordinates, a pixel-exact .png ControlNet guide mask, LDtk JSON, and Material Maker PBR recipes. No sibling tool in the list produces tilesets, so the agent can identify this tool's role instantly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description names the three modes but never says when to pick blob_47 vs wang_16_cardinal vs isometric_diamond_2to1, nor whether project_id must reference an initialized project (gameforge_init_project exists as a sibling). No exclusions or alternatives are offered, so the agent gets no usage routing.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

gameforge_generate_turnaround_workflowB

Build (and optionally dispatch to ComfyUI) a self-adapting 4-View Orthographic Character Turnaround workflow supporting both split UNETLoader+DualCLIPLoader+FluxGuidance and merged checkpoints + dynamic BiRefNet/RMBG alpha matting.

NameRequiredDescriptionDefault
project_idYes
character_idYes
resolution_widthNoDefault 1536
workflow_profileNoAuto-detects from ComfyUI /object_info when 'auto'
resolution_heightNoDefault 768
submit_to_comfyuiNo

TDQS

B3.1/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations exist, so the description carries the whole burden. It usefully discloses the dual-mode adaptivity and, importantly, that the tool can dispatch to an external ComfyUI server — a side effect an agent must plan around. It says nothing about whether artifacts are written to disk, what happens when ComfyUI is unreachable, or whether a submitted job is awaited or fire-and-forget.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single front-loaded sentence with the action verb first and no filler. It is dense with pipeline-specific node names, which is efficient for an informed agent though mildly jargon-heavy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a six-parameter generation tool with no annotations and no output schema, the description omits what the tool returns or produces, where assets land, and how failure of an optional ComfyUI dispatch is reported. Those gaps matter more here because nothing structured fills them.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 50%: resolution defaults and the workflow_profile enum are already described in the schema. The description's main added value is clarifying that dispatch to ComfyUI is optional, which maps to submit_to_comfyui. project_id and character_id remain entirely undocumented in both places.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource: build a 4-View Orthographic Character Turnaround workflow, with the option to dispatch it to ComfyUI. The node-level detail (UNETLoader/DualCLIPLoader/FluxGuidance vs merged checkpoints, BiRefNet/RMBG matting) makes the scope concrete. It does not differentiate itself from the close sibling gameforge_generate_consistent_sprites_workflow, so an agent must infer which generator applies.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no statement of when to choose this over gameforge_generate_consistent_sprites_workflow or gameforge_generate_3d_from_sheet, nor prerequisites such as an initialized project, registered character, or a running ComfyUI instance. The only usage signal is implicit in the workflow_profile 'auto' option, which is documented in the schema, not the description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

gameforge_init_projectB

Initialize or update a deterministic game project in the SQLite Style Vault using studio camera math presets (Ragnarok 2.5D, Tree of Savior Ortho 3D, Diablo 2:1 Dimetric, Tactics 35.264° Iso, HD-2D, Dead Cells 3D-to-2D, or 2D Platformer). Creates standard asset directories and gameforge.project.json.

NameRequiredDescriptionDefault
titleYesHuman-readable game title
project_idYesUnique slug (e.g. 'valkyrie-chronicle' or 'rune-blade')
genre_presetYesStudio camera & pipeline preset
target_engineNoPrimary engine target (default: godot)
workspace_dirYesAbsolute directory path where project assets and scripts will be generated
directions_overrideNoOptional directional count override
pixels_per_unit_overrideNoOptional custom PPU override

TDQS

B3.4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden; it does disclose the concrete write side effects (creates standard asset directories and gameforge.project.json) and the 'update' mode. It does not say whether re-running overwrites existing manifest/directory contents, whether it fails if the directory already exists, or what the tool returns.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, verb-first and front-loaded, with no filler. The preset enumeration is long but earns its place by mapping enum values to recognizable camera styles.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a seven-parameter mutation tool with no annotations and no output schema, the description covers the core action and created artifacts but omits idempotency/overwrite semantics, error conditions, and return value. Enough to call it, not enough to call it confidently in a pipeline.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all seven parameters and three enums, establishing a baseline of 3. The description adds modest value by naming the real-world camera presets that map to the genre_preset enum values, but says nothing about workspace_dir, target_engine, or the override parameters.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource: initialize/update a deterministic game project in the 'SQLite Style Vault'. It also enumerates the camera-math presets, which helps distinguish it from style-bible and export siblings. The only fuzziness is what 'SQLite Style Vault' and 'deterministic' operationally mean, and 'or update' leaves the exact lifecycle role slightly ambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies a setup step (it creates directories and the project manifest), but it never says this must be called before the sibling generation/export tools, nor when to re-run it versus leaving the project alone. No alternatives or exclusions are named, so the agent must infer ordering from the tool name alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

gameforge_introspect_comfyuiA

Probe a live ComfyUI /object_info endpoint to auto-detect installed loader architectures (UNETLoader + DualCLIPLoader split FLUX vs merged checkpoints), ControlNet, IP-Adapter/PuLID, and alpha matting nodes (BiRefNet, RMBG, etc.).

NameRequiredDescriptionDefault
comfy_urlNoDefaults to COMFYUI_URL or http://127.0.0.1:8188

TDQS

A3.8/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden, and it usefully discloses that this hits a *live* endpoint (implying ComfyUI must be running and reachable, i.e. a network dependency and likely read-only GET). It does not describe behavior on unreachable endpoints, timeouts, or the shape of returned data.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single front-loaded sentence that opens with the action and branches into detection targets. It is dense with backtick-quoted node names but every element is substantive rather than filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Purpose and detection scope are covered, but with no output schema the description never explains what the agent gets back (node list, capability flags, booleans?) or how to interpret a partial/failed probe. For a diagnostic tool that is a meaningful gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and the single parameter `comfy_url` already documents its env-var/default fallback. The description adds no further meaning about the URL parameter, so baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (Probe) and resource (live ComfyUI `/object_info` endpoint), plus the exact categories it detects (loader architectures, ControlNet, IP-Adapter/PuLID, alpha matting nodes). This is clearly distinguishable from every sibling, none of which touch ComfyUI introspection.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied — an agent would infer you run this to check what's installed before generating ComfyUI workflows — but there is no explicit when-to-use, prerequisite, or alternative stated. Nothing directs the agent to call this before generating any of the sibling workflow tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

gameforge_libresprite_cleanup_scriptB

Generate (and optionally run via LibreSprite / Aseprite CLI) a Lua batch script for custom artist touch-ups, .aseprite layer packaging, and .gpl palette loading.

NameRequiredDescriptionDefault
clip_nameYes
project_idYes
execute_cliNo
alpha_cutoffNo
character_idYes

TDQS

B3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must carry the full behavioral burden. It discloses that execution is optional via LibreSprite/Aseprite CLI, but it does not state required CLI availability, file side effects, overwrite behavior, permissions, or what running the script changes on disk.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The definition is a single front-loaded sentence with no filler. The primary action and optional execution mode are stated before the use cases.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

This is a relatively complex tool with five inputs, no annotations, no output schema, and no parameter descriptions. The description says what kind of script is generated but not enough about required inputs, generated output, CLI requirements, or execution safety for an agent to call it confidently.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% across five parameters. The description only vaguely maps to `execute_cli` via 'optionally run via LibreSprite / Aseprite CLI'; it leaves `project_id`, `character_id`, `clip_name`, and `alpha_cutoff` unexplained.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb and resource: 'Generate (and optionally run ...) a Lua batch script.' It also names concrete use cases such as `.aseprite` layer packaging and `.gpl` palette loading, making the tool distinguishable from export and workflow siblings, though it does not explicitly contrast them.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The use cases imply when an agent might select this tool: custom artist touch-ups, layer packaging, and palette loading. However, it gives no explicit when-not conditions, prerequisites, or direct alternatives among the many gameforge siblings.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

gameforge_lock_style_bibleB

Lock the visual Style Bible for a project: computes hue-shifted 5-step shadow-to-highlight color ramps, outline thickness, shading model, open-source checkpoint/LoRA names, and safe ControlNet + IP-Adapter + Denoise bounds so AI passes never drift.

NameRequiredDescriptionDefault
accent_hexYesAccent 10% focal hex (e.g. '#F4B41A')
outline_pxNoOutline weight in pixels (0 for lineless PBR, 1 for pixel/cel, 1.5 for painterly)
project_idYes
denoise_maxNoMaximum denoise over 3D render before silhouette drift (default: 0.48)
denoise_minNoMinimum denoise over 3D render (default: 0.35)
primary_hexYesPrimary 60% world/character base hex (e.g. '#3B5DC9')
secondary_hexYesSecondary 30% structural hex (e.g. '#7D5A4F')
shading_styleNo
base_checkpointNoOpen-weights checkpoint filename (default: 'flux1-dev-fp8.safetensors')
style_lora_nameNoOptional local LoRA filename trained via FluxGym/Kohya
ipadapter_weightNoIP-Adapter weight (0.55-0.70 prevents pose lockup while preserving identity)
outline_color_hexNoDark chromatic outline hex (avoid pure #000000; default '#181425')
style_lora_strengthNoLoRA strength (default: 0.75)
negative_lock_tokensNoTokens strictly banned across all assets
art_direction_summaryYesClear description of visual aesthetic (e.g. 'Soft watercolor fantasy linework with warm parchment highlights and deep indigo shadows')
positive_style_tokensNoComma-separated style prompt tokens

TDQS

B3.4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations exist, so the description carries the full burden. 'Lock' implies a persistent mutation, but the description never says whether the lock is reversible, what happens if called twice, or what permissions/state it requires — only that project_id is needed. It does partially compensate by disclosing the computed artifact set (ramps, bounds, checkpoint names), which effectively hints at output content.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single sentence with the action front-loaded before the colon and the substance enumerated after it — dense but every phrase carries information. It is slightly overstuffed as one clause chain, but there is no filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 16-parameter, 5-required tool with no annotations and no output schema, the description usefully summarizes the produced artifact, but it omits persistence semantics, return shape, and error behavior (e.g. invalid hex, missing project). Adequate but with clear gaps given the tool's complexity and total absence of annotations.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 88%, with per-field descriptions including defaults, ranges, and enum values, so the schema already does the heavy lifting. The description adds no parameter-level detail beyond what is in the schema, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb ('Lock') and resource ('the visual Style Bible for a project'), then enumerates exactly what gets computed: hue-shifted 5-step ramps, outline thickness, shading model, checkpoint/LoRA names, and ControlNet/IP-Adapter/denoise bounds. This is clearly distinguishable from siblings like gameforge_audit_asset_consistency or the various generate_*_workflow tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The trailing clause 'so AI passes never drift' explains the benefit but not the trigger condition. There is no statement of when to call this (e.g. before any asset generation), no prerequisite that a project must already exist, and no named alternative or exclusion relative to the sibling audit/workflow tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

gameforge_query_codexC

Query the embedded GameForge Technical Art & Engine Studio Codex.

NameRequiredDescriptionDefault
queryNo

TDQS

C2.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden; it discloses only the word "embedded," hinting at a local knowledge base. It says nothing about whether this is read-only, what kind of results come back (documents? snippets? citations?), or whether the query must be natural language vs. keywords.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single front-loaded sentence with no padding, but its brevity comes from under-specification rather than efficiency. There is room to add a clause on query form and return type without bloating.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a retrieval tool with no annotations, no output schema, and an undescribed parameter, the description should explain what gets returned and in what shape. It does neither, so an agent cannot predict the result of calling it.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

One parameter with 0% schema description coverage, and the description adds no guidance on what to put in it — search phrase, question, topic keyword, or entity name. The parameter name alone does not compensate for the schema gap.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

It has a specific verb and resource ("Query" + "GameForge Technical Art & Engine Studio Codex"), so the agent knows it interrogates some knowledge base. But the resource is opaque — nothing says what the Codex contains or how it differs from the many sibling generation/export tools. Adequate minimum, clear gaps.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no when-to-use, when-not-to-use, or alternative named. Given 24 siblings with overlapping-sounding names, the agent has no signal about when to consult the Codex versus calling gameforge_discover_ecosystem or gameforge_audit_asset_consistency.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

gameforge_register_characterB

Register a playable hero, NPC, mob, mount, or boss in the Project Vault. Computes exact foreshortened orthographic pixel height from physical meter scale (height_m * cos(pitch) * PPU), generates a deterministic seed, and locks Paper-Doll bone sockets.

NameRequiredDescriptionDefault
roleNo
project_idYes
character_idYesSlug ID (e.g. 'crusader_f' or 'ash_demon_boss')
display_nameYes
mesh_3d_pathNo
rig_templateNoOpen-source rigging template
height_metersYesPhysical height in meters (e.g. 1.75 for human, 0.95 for goblin, 3.4 for boss)
paperdoll_enabledNoEnable modular swappable gear sockets (Ragnarok/Diablo style)
turnaround_sheet_pathNo
lore_and_visual_promptYesCanonical visual design prompt for armor/clothing/silhouette

TDQS

B3.2/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden, and it does disclose real behavior: it computes orthographic pixel height, deterministically seeds, and 'locks' Paper-Doll bone sockets — implying a mutation with a locking step. However it omits permission requirements, whether re-registering an existing character_id overwrites or fails, and whether 'locking' is reversible. Useful but incomplete for a 10-param mutation tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single dense sentence, front-loaded with the primary action, then the three computed side effects. No filler or redundancy. It borders on cramped — three distinct behaviors stacked without separation — but every clause earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 10-parameter, 5-required mutation tool with no annotations and no output schema, the description explains the core action and the derived values but never states what is returned (the computed pixel height, the seed, socket metadata) or the prerequisite project context. Adequate to start an invocation, not adequate to invoke confidently.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 50%, so several parameters (project_id, mesh_3d_path, turnaround_sheet_path, display_name) are undocumented anywhere. The description does add value for height_meters by giving the exact formula (height_m * cos(pitch) * PPU), although pitch and PPU are not parameters, and it implicitly touches paperdoll_enabled and lore_and_visual_prompt. It does not compensate for the remaining coverage gap.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource — 'Register a playable hero, NPC, mob, mount, or boss in the Project Vault' — matching the enum roles in the schema. It also names three concrete side effects (pixel height computation, seed generation, bone socket locking). It does not differentiate itself from near siblings like gameforge_build_complete_character_slice or gameforge_blender_rig_and_sockets, which an agent could easily confuse with registration.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no statement of when this tool should be used versus alternatives, no prerequisites (e.g., that a project must exist via gameforge_init_project), and no guidance on ordering relative to rig/socket or sprite-generation tools. The agent must infer that registration precedes the downstream build pipeline.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

gameforge_synthesize_procedural_framesB

Instantly synthesize physically shaded 8/16-direction animated 2.5D character PNG frames + true Camera-Space Tangent Normal Maps (R=+X, G=+Y, B=+Z) + modular Paper-Doll Weapon & Cape overlay frames + sockets_per_frame.json in pure Node.js (<250ms, zero GPU/Blender required for instant engine & shader prototyping!).

NameRequiredDescriptionDefault
clip_nameYese.g. 'walk', 'idle', 'slash_combo_1'
project_idYes
character_idYes
frames_per_directionNoDefault 6

TDQS

B3.1/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must carry the full behavioral burden. It does disclose real traits: sub-250ms runtime, no GPU/Blender dependency, and the concrete set of outputs generated. However, it is silent on the actual side effects of a generation tool — where frames are written, whether existing frames are overwritten, and what happens on an unknown project_id/character_id.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Correction: this is a single run-on sentence stuffed with backticks, inline parentheticals, a color-channel aside, and an exclamation mark, so it is neither well-structured nor free of noise.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The rich enumeration of return artifacts partially substitutes for the absent output schema, which is genuinely useful. But for a 3-required-parameter generation tool with zero annotations and half its parameters undocumented, the missing preconditions, output locations, and overwrite behavior leave real gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 50% (project_id and character_id are bare strings), so the description needed to compensate and does not. It never explains clip_name semantics, how frames_per_direction interacts with the advertised '8/16-direction' output, or what project_id/character_id must reference — the '8/16-direction' phrasing actually dangles without a corresponding parameter.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Names a specific verb (synthesize) and enumerates the exact artifacts produced: PNG frames, Camera-Space Tangent Normal Maps, paper-doll overlay frames, and sockets_per_frame.json. It is distinguishable in flavor from the Blender-based siblings by the 'pure Node.js, zero GPU/Blender' qualifier, though no sibling is ever named.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The only usage signal is the trailing phrase 'for instant engine & shader prototyping', which hints at a context but never states when to pick this over gameforge_blender_rig_and_sockets or gameforge_generate_consistent_sprites_workflow. No exclusions, no prerequisites (e.g. whether the project/character must already exist via gameforge_init_project), no when-not-to-use.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 24 tool updatesv2.0.0
    • First observedgameforge_audit_asset_consistency
    • First observedgameforge_blender_ortho_turntable_bake
    • First observedgameforge_blender_rig_and_sockets
    • First observedgameforge_build_complete_character_slice
    • First observedgameforge_compile_sprite_atlas
    • First observedgameforge_compute_paperdoll_zorder
    • First observedgameforge_define_combat_framedata
    • First observedgameforge_discover_ecosystem
    • First observedgameforge_export_godot_package
    • First observedgameforge_export_unity_package
    • First observedgameforge_export_unreal_package
    • First observedgameforge_generate_3d_from_sheet
    • First observedgameforge_generate_consistent_sprites_workflow
    • First observedgameforge_generate_interactive_preview
    • First observedgameforge_generate_lora_dataset_plan
    • First observedgameforge_generate_tileset_spec
    • First observedgameforge_generate_turnaround_workflow
    • First observedgameforge_init_project
    • First observedgameforge_introspect_comfyui
    • First observedgameforge_libresprite_cleanup_script
    • First observedgameforge_lock_style_bible
    • First observedgameforge_query_codex
    • First observedgameforge_register_character
    • First observedgameforge_synthesize_procedural_frames

TDQS

B3/5.0

Scored across 24 tools

Disambiguation3/5

Most tools have distinct, well-scoped purposes (engine exports, Blender rigging, atlas compilation), but several overlap in the 'produce character frames/normals' space: synthesize_procedural_frames, blender_ortho_turntable_bake, and compile_sprite_atlas all output sprite frames + normal maps from different sources. The mega-tool build_complete_character_slice also overlaps with nearly every other tool, and discover_ecosystem vs introspect_comfyui both probe local tooling, creating real selection ambiguity.

Naming Consistency4/5

All names use a consistent gameforge_ prefix and snake_case, with action-first verbs for the majority (export_*, generate_*, init_*, lock_*, register_*, compute_*, define_*, compile_*, build_*). Minor deviations exist where a tool name is prefixed by the external tool instead of a verb (blender_rig_and_sockets, blender_ortho_turntable_bake, libresprite_cleanup_script), but the overall pattern is predictable.

Tool Count4/5

At 24 tools the surface is on the heavy side, but the server genuinely spans a large end-to-end game art pipeline (discovery, style, rigging, baking, atlases, three engine exporters, audit), so most tools earn their place. It is close to the 25-tool 'heavy' threshold, making it slightly over-scoped but defensible.

Completeness4/5

Coverage is broad and includes create/init, generation workflows, three engine exporters, preview, and QA audit, forming a near-complete asset lifecycle. Gaps remain: there is no tool to list/inspect existing project assets or state beyond query_codex, and no delete/cleanup or update path for already-generated artifacts, which agents may need when iterating.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    C
    maintenance
    Enables users to automate the creation, editing, animation, and export of pixel-art game assets through a multi-agent pipeline that derives style specs and blueprints, generates Lua build scripts, and drives the canvas editor to produce .aseprite files, spritesheets, atlases, GIFs, and previews.
    12
    72 npm
    3
    MIT
  • A
    license
    B
    quality
    C
    maintenance
    Enables AI agents to procedurally design and render stylized 2:1 dimetric isometric game assets in Blender, including NPR cel-shaded scenes, modular tilesets, 8-angle avatar turnarounds, and mathematically exact subpixel collision diamonds, with turnkey engine manifests for Phaser, Godot 4, and retro web games.
    10
    Apache 2.0