GameForge MCP
Bridges LibreSprite/Aseprite-style pixel-art workflows, emitting locked .gpl palettes, CIELAB-quantized sprites, and 1px chromatic outlines for pixel-perfect 2D asset editing and export.
Drives Blender 4.x as a deterministic technical-art backend: builds a 20-bone game humanoid rig, retargets Mixamo .fbx animations, generates procedural clips (idle, walk, run, slash, cast, death), and bakes orthographic multi-pass renders (beauty, depth, Freestyle lineart, tangent normal maps) across 8/16 directions.
Exports zero-placeholder Unity assets: C# AssetPostprocessor with pre-sliced SpriteMetaData[] and URP 2D _NormalMap binding, plus StudioBuilder.cs that wires ObjectReferenceKeyframe[] sprite curves into .anim clips and saves .prefab files.
Provides UE5 Python import tooling that ingests albedo and normal-map PNGs into directional PaperFlipbook assets and sets up orthographic SpringArm camera rigs for Paper2D/2.5D projects.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@GameForge MCPgenerate an 8-direction walk atlas for my paladin with a locked palette"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
GameForge MCP (gameforge-mcp)
The 100% Open-Source Game Studio & AI Asset Consistency Gateway (Model Context Protocol) — v2.0.0
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, andnode:http. Includes a custom RFC-2083 binary PNG decoder/encoder, CIEL*a*b*perceptual palette quantizer, and tangent-space normal-map stitcher with zeronode-gypbuild 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 ( | Paired Camera-Space Tangent Normal Atlas ( |
|
|
100% CIE | Dynamic 2D/2.5D Torchlight Ready ( |
Canonical 47-Tile Blob Auto-Tile Bitmask Template (sanctuary_blob47_template_mask.png)

Interactive 2.5D Torchlight & Paper-Doll Studio: Open
examples/valkyrie-25d-showcase/atlases/aegis_paladin_preview_studio.htmldirectly in any browser to drag a live 3D point light across the tangent normal map, toggle modular sword/cape Paper-Doll layers with directional Z-sorting, scrub all 8 directions, and inspect the locked foot-pivot crosshair.
Related MCP server: game-agent-factory
What's New in v2.0.0
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) andnode:zlibencoder. Strips AI alpha halos (alpha < threshold → 0,>= threshold → 255), snaps every pixel to your locked.gplpalette in perceptual CIEL*a*b*space (with optional4×4Bayer dithering), injects 1px chromatic outlines, locks every frame's lowest opaque pixel to an exact foot-pivot baseline (0pxvertical jitter), and stitches paired Albedo + Tangent Normal-Map sprite sheets.Self-Adapting ComfyUI Live Introspector (
src/wings/comfy-wing.mjs) — Queries liveGET /object_infoon 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 stockLoadImagesubmission whenVHS_LoadImagesPathis absent.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-spinechain,shoulder/upper_arm/forearm/DEF-hand.L/R,thigh/shin/foot.L/R), retargets external Mixamo.fbxanimations (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.Zero-Placeholder Pre-Sliced Godot 4, Unity C#, and Unreal 5 Exporters + 10-Point Pixel QA Gate (
src/wings/engine-wing.mjs) — Godot.trespre-slices everyCols × RowsSubResource("AtlasTexture_...")Rect2region and wiresCanvasTexturediffuse + normal maps; Unity C#AssetPostprocessorslicesSpriteMetaData[]+ binds URP 2D_NormalMapwhileStudioBuilder.cswiresObjectReferenceKeyframe[]sprite curves into.animclips + saves.prefab; UE5 Python imports Albedo + Normal PNGs into directionalPaperFlipbookassets; andgameforge_audit_asset_consistencyverifies binary pixel compliance across 10 deterministic checks.One-Shot Vertical Slice Compiler & Standalone HTML5 Torchlight Studio (
src/wings/preview-wing.mjs) —gameforge_build_complete_character_sliceexecutes 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 Online |
| 8 ( |
| 3D World + 8-dir layered Paper-Doll sprites with per-angle Z-order swaps |
| Tree of Savior |
| 8 / 360° |
| Live rigged 3D low/mid-poly meshes with hand-painted unlit/toon + inverted-hull outlines |
| Diablo II: Resurrected |
| 16 ( |
| Exact 2:1 pixel-dimetric 16-angle pre-rendered sprites + contact shadows + normal maps |
| FF Tactics / Tactics Ogre |
| 4 ( |
| True CAD isometric grid elevation tactics |
| Octopath Traveler |
| 8 ( |
| 3D PBR tilt-shift diorama world + point-filtered pixel billboards lit by 3D lights |
| Dead Cells |
| 2 ( |
| Blender |
| Celeste / Hollow Knight |
| 2 ( |
| 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 testAdd 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)
gameforge_init_project— Locks camera projection, pitch, PPU, tile diamond ratio, sun vector, and asset folders.gameforge_lock_style_bible— Generates hue-shifted 5-step color ramps,.gplGIMP/LibreSprite palettes, and safe ComfyUI denoise bounds.gameforge_register_character— Computes foreshortened orthographic pixel height (height_m × cos(pitch) × PPU), deterministic seed, and bone sockets.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).gameforge_define_combat_framedata— Stores animation FPS,startup/active/recoverycombat windows, hitstop ms, and AABB hitboxes.
Wing B — Self-Adapting ComfyUI Turnaround, Style Lock & FluxGym LoRA (src/wings/comfy-wing.mjs)
gameforge_introspect_comfyui— Queries live ComfyUIGET /object_infoto detect split FLUX (UNETLoader), checkpoints, ControlNet, IP-Adapter, BiRefNet/RMBG, and VHS batch nodes.gameforge_generate_turnaround_workflow— Builds/submits split-FLUX or merged-checkpoint + BiRefNet 4-view orthographic turnaround ComfyUI API graphs.gameforge_generate_consistent_sprites_workflow— Multi-pass ControlNet (Depth + Lineart) + IP-Adapter + clamped denoise + BiRefNet sprite workflow (with loop-free stockLoadImagefallback).gameforge_generate_lora_dataset_plan— Generates FluxGym / Kohya.tomlconfigs 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)
gameforge_generate_3d_from_sheet— Self-hosted Python runners for TRELLIS.2, Hunyuan3D 2.1, and MIT TripoSR + UniRig follow-up.gameforge_blender_rig_and_sockets— Generates/executes Blender 4.xbpyscripts for metric scaling, 20-bone game armature binding, Mixamo.fbxretargeting, 6 procedural animation clips, Paper-DollEmptysockets, and Tree of Savior inverted-hull outlines.gameforge_blender_ortho_turntable_bake— Renders 8/16-direction Beauty, Depth, Freestyle 1px Lineart,[0..1]Camera-Space Tangent Normal Map, and projectedsockets_per_frame.jsonpixel coordinates.
Wing D — Native Binary PNG Codec, CIELAB Quantizer & LibreSprite Cleanup (src/wings/sprite-wing.mjs)
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.gameforge_compile_sprite_atlas— Native RFC-2083 binary PNG decoder/encoder that strips semi-transparent alpha fringes, quantizes to.gplpalettes in CIEL*a*b*, injects 1px chromatic outlines, locks0pxfoot-pivot jitter, and stitches paired Albedo + Normal-Map sprite sheets.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)
gameforge_generate_tileset_spec— Computes canonical 47-tile Blob & 16-tile Wang bitmasks, renders a pixel-exact.pngbitmask 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)
gameforge_export_godot_package— Exports Godot 4.tscn, pre-slicedCols × RowsAtlasTextureSpriteFrames.tres, Normal-LitCanvasTexture, and 2D/2.5D GDScript controllers.gameforge_export_unity_package— Exports Unity C#AssetPostprocessor(SpriteMetaData[]slicer +_NormalMapbinding),ObjectReferenceKeyframe[].anim+ 8-wayBlendTree+.prefabbuilder, and runtime Y-Sort/Hitstop scripts.gameforge_export_unreal_package— Exports Unreal Engine 5 Python scripts importing Albedo + Normal PNGs, generating directionalPaperFlipbookassets, and configuring OrthographicSpringArmcameras.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,0semi-transparent fringe pixels, normal-map parity, Paper-Doll Z-matrix, and combat frame-data (0–100).gameforge_discover_ecosystem— Live probe for BlenderMCP socket, Blender CLI, ComfyUI, TRELLIS/UniRig, Godot 4, LibreSprite, and Ollama.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)
gameforge_generate_interactive_preview— Builds a self-contained HTML5 2.5D Normal-Lit Torchlight & Paper-Doll Inspection Studio with embedded base64 atlases, real-timeN·Lpoint-light shader math, modular gear toggles, and foot-pivot crosshair overlay.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 toolsgameforge_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).
| Name | Required | Description | Default |
|---|---|---|---|
| clip_name | No | Clip to pixel-verify (defaults to first character animation or 'walk') | |
| project_id | Yes | ||
| character_id | No |
TDQS
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.
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.
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.
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.
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.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| clip_name | No | Action clip to activate & bake (default 'walk') | |
| frame_end | No | ||
| project_id | Yes | ||
| frame_start | No | ||
| character_id | Yes | ||
| execute_in_blender | No | ||
| pixel_crisp_aa_off | No |
TDQS
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.
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.
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.
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.
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.
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!
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | ||
| character_id | Yes | ||
| execute_in_blender | No | ||
| external_mixamo_fbx_path | No | Optional external Mixamo / UniRig animated .fbx or .glb to retarget onto the 19-bone rig | |
| generate_mannequin_if_mesh_missing | No |
TDQS
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.
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.
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.
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.
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.
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)!
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | ||
| clip_name | No | ||
| accent_hex | No | ||
| project_id | Yes | ||
| primary_hex | No | ||
| character_id | Yes | ||
| display_name | No | Alias for character_name | |
| genre_preset | Yes | ||
| height_meters | No | ||
| secondary_hex | No | ||
| visual_prompt | No | ||
| workspace_dir | Yes | ||
| character_name | No | ||
| art_direction_summary | No |
TDQS
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.
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.
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.
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.
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.
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!
| Name | Required | Description | Default |
|---|---|---|---|
| clip_name | Yes | ||
| frames_dir | No | ||
| project_id | Yes | ||
| character_id | Yes | ||
| auto_align_foot_pivot | No | Eliminate frame-to-frame vertical floating (default true) | |
| bayer_dither_strength | No | Optional 4x4 Bayer pixel dither 0..32 (default 0) | |
| quantize_to_style_palette | No | Snap colors in CIELAB space to Style Bible (default true) |
TDQS
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.
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.
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.
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.
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.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| directions | No | Defaults to project's direction count | |
| project_id | Yes | ||
| character_id | Yes |
TDQS
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.
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.
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.
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.
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.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| fps | Yes | Playback frames per second (e.g. 12 for crisp sprite anims, 24 for fluid) | |
| looping | No | ||
| hitboxes | No | Active hitbox rectangles relative to character foot pivot in pixels | |
| clip_name | Yes | e.g. 'idle', 'run', 'slash_combo_1', 'dash', 'cast_holy', 'hitstun', 'death' | |
| hitstop_ms | No | Impact freeze-frame duration in milliseconds (e.g. 65) | |
| project_id | Yes | ||
| character_id | Yes | ||
| total_frames | Yes | ||
| active_frames | No | Frames where weapon/skill hitbox deals damage | |
| startup_frames | No | Wind-up telegraph frames before hitbox activates | |
| recovery_frames | No | Follow-through frames after active window |
TDQS
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.
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.
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.
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.
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.
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).
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
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.
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.
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.
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.
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.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | ||
| character_id | Yes |
TDQS
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.
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.
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.
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.
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.
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!
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | ||
| character_id | Yes |
TDQS
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.
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.
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.
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.
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.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | ||
| character_id | Yes |
TDQS
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.
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.
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.
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.
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.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | ||
| character_id | Yes | ||
| target_faces | No | ||
| open_model_backend | No |
TDQS
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.
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.
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.
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.
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.
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!).
| Name | Required | Description | Default |
|---|---|---|---|
| clip_name | Yes | ||
| project_id | Yes | ||
| character_id | Yes | ||
| denoise_strength | No | ||
| workflow_profile | No | ||
| submit_to_comfyui | No |
TDQS
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.
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.
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.
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.
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.
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!
| Name | Required | Description | Default |
|---|---|---|---|
| clip_name | No | Clip to embed (default 'walk') | |
| project_id | Yes | ||
| character_id | Yes |
TDQS
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.
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.
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.
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.
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.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | ||
| network_dim | No | ||
| character_id | No | ||
| trigger_token | Yes | ||
| max_train_steps | No |
TDQS
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.
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.
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.
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.
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.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | ||
| tileset_id | Yes | ||
| autotile_mode | No | ||
| biome_description | Yes |
TDQS
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.
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.
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.
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.
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.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | ||
| character_id | Yes | ||
| resolution_width | No | Default 1536 | |
| workflow_profile | No | Auto-detects from ComfyUI /object_info when 'auto' | |
| resolution_height | No | Default 768 | |
| submit_to_comfyui | No |
TDQS
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.
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.
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.
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.
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.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | Human-readable game title | |
| project_id | Yes | Unique slug (e.g. 'valkyrie-chronicle' or 'rune-blade') | |
| genre_preset | Yes | Studio camera & pipeline preset | |
| target_engine | No | Primary engine target (default: godot) | |
| workspace_dir | Yes | Absolute directory path where project assets and scripts will be generated | |
| directions_override | No | Optional directional count override | |
| pixels_per_unit_override | No | Optional custom PPU override |
TDQS
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.
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.
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.
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.
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.
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.).
| Name | Required | Description | Default |
|---|---|---|---|
| comfy_url | No | Defaults to COMFYUI_URL or http://127.0.0.1:8188 |
TDQS
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.
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.
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.
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.
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.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| clip_name | Yes | ||
| project_id | Yes | ||
| execute_cli | No | ||
| alpha_cutoff | No | ||
| character_id | Yes |
TDQS
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.
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.
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.
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.
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.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| accent_hex | Yes | Accent 10% focal hex (e.g. '#F4B41A') | |
| outline_px | No | Outline weight in pixels (0 for lineless PBR, 1 for pixel/cel, 1.5 for painterly) | |
| project_id | Yes | ||
| denoise_max | No | Maximum denoise over 3D render before silhouette drift (default: 0.48) | |
| denoise_min | No | Minimum denoise over 3D render (default: 0.35) | |
| primary_hex | Yes | Primary 60% world/character base hex (e.g. '#3B5DC9') | |
| secondary_hex | Yes | Secondary 30% structural hex (e.g. '#7D5A4F') | |
| shading_style | No | ||
| base_checkpoint | No | Open-weights checkpoint filename (default: 'flux1-dev-fp8.safetensors') | |
| style_lora_name | No | Optional local LoRA filename trained via FluxGym/Kohya | |
| ipadapter_weight | No | IP-Adapter weight (0.55-0.70 prevents pose lockup while preserving identity) | |
| outline_color_hex | No | Dark chromatic outline hex (avoid pure #000000; default '#181425') | |
| style_lora_strength | No | LoRA strength (default: 0.75) | |
| negative_lock_tokens | No | Tokens strictly banned across all assets | |
| art_direction_summary | Yes | Clear description of visual aesthetic (e.g. 'Soft watercolor fantasy linework with warm parchment highlights and deep indigo shadows') | |
| positive_style_tokens | No | Comma-separated style prompt tokens |
TDQS
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.
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.
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.
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.
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.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| query | No |
TDQS
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.
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.
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.
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.
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.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | ||
| project_id | Yes | ||
| character_id | Yes | Slug ID (e.g. 'crusader_f' or 'ash_demon_boss') | |
| display_name | Yes | ||
| mesh_3d_path | No | ||
| rig_template | No | Open-source rigging template | |
| height_meters | Yes | Physical height in meters (e.g. 1.75 for human, 0.95 for goblin, 3.4 for boss) | |
| paperdoll_enabled | No | Enable modular swappable gear sockets (Ragnarok/Diablo style) | |
| turnaround_sheet_path | No | ||
| lore_and_visual_prompt | Yes | Canonical visual design prompt for armor/clothing/silhouette |
TDQS
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.
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.
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.
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.
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.
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!).
| Name | Required | Description | Default |
|---|---|---|---|
| clip_name | Yes | e.g. 'walk', 'idle', 'slash_combo_1' | |
| project_id | Yes | ||
| character_id | Yes | ||
| frames_per_direction | No | Default 6 |
TDQS
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.
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.
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.
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.
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.
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.
24 tool updates
v2.0.0- First observed
gameforge_audit_asset_consistency - First observed
gameforge_blender_ortho_turntable_bake - First observed
gameforge_blender_rig_and_sockets - First observed
gameforge_build_complete_character_slice - First observed
gameforge_compile_sprite_atlas - First observed
gameforge_compute_paperdoll_zorder - First observed
gameforge_define_combat_framedata - First observed
gameforge_discover_ecosystem - First observed
gameforge_export_godot_package - First observed
gameforge_export_unity_package - First observed
gameforge_export_unreal_package - First observed
gameforge_generate_3d_from_sheet - First observed
gameforge_generate_consistent_sprites_workflow - First observed
gameforge_generate_interactive_preview - First observed
gameforge_generate_lora_dataset_plan - First observed
gameforge_generate_tileset_spec - First observed
gameforge_generate_turnaround_workflow - First observed
gameforge_init_project - First observed
gameforge_introspect_comfyui - First observed
gameforge_libresprite_cleanup_script - First observed
gameforge_lock_style_bible - First observed
gameforge_query_codex - First observed
gameforge_register_character - First observed
gameforge_synthesize_procedural_frames
TDQS
Scored across 24 tools
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.
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.
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.
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
Related MCP Connectors
AI game assets for agents: consistent sprites, 2D animations, tiles, maps, music and engine exports.
Generate game-ready 3D models, textures, and audio from natural language, over MCP.
Build editable 3D scenes, direct characters and cameras, and export AI video references with MCP.
Turn prompts into production-ready game assets: animated characters, textures, terrain, VFX, HUD.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceAn MCP server that lets AI agents draw in a live Aseprite editor or headless mode, featuring one-action Unity sprite-sheet export, art-QA sweeps, and game-dev tools.97 PyPI8MIT
- FlicenseNot gradedqualityBmaintenanceEnables automated game development by orchestrating multi-agent teams (design, programming, 2D/3D art, supervision, QA) through LangGraph and an MCP gateway that drives Blender, Krita, Godot, and Git to produce runnable game builds.2-
- AlicenseBqualityCmaintenanceEnables 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.1272 npm3MIT
- AlicenseBqualityCmaintenanceEnables 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.10Apache 2.0

