Tool reference

All 66 tools the Gamentic MCP server exposes. Your assistant discovers these automatically — this page is here so you can tell whether it is using the right one.

Prices are in credits, at 1,000 credits to about US$1. Anything not marked with a price is free — all reading, writing, editing, validating and testing of game code costs nothing.

Setting up a run

ToolWhat it doesCredits
get_conventionGet the game convention (REQUIRED before writing a game)
get_skillGet a game-development knowledge pack
budget_statusHow many credits this game has cost so far
set_active_walletChoose which credit wallet to bill (personal / team)
submit_feedbackRecord the practical lesson learned from this game (self-learning)
list_learnedView accumulated practical-notes stats

The questionnaire

ToolWhat it doesCredits
new_game_briefOpen the new-game questionnaire
wait_for_briefWait for the user to submit the form (call right after giving the formUrl)
get_game_briefRead the questionnaire answers

Making and changing games

ToolWhat it doesCredits
use_templateBuild a game from a full-code template (the platform writes every file)
create_gameRegister a new game (ALWAYS call after writing one)
update_gameUpdate the game source (structural changes)
edit_gameEdit the game in place (preferred way to change a game)
get_gameGet the latest game state
list_gamesList the games you can see
validate_gameValidate a game (without storing it)
search_game_sourceSearch the game source
set_genreChange a game's Explore category (genre) after creation
remix_gameRemix someone else's public game (copy it for yourself to edit)

Source files

ToolWhat it doesCredits
list_game_filesList the source files of a game
read_game_fileRead one source file of a game
write_game_fileCreate / overwrite one source file of a game
edit_game_filePrecise find/replace inside one source file
begin_game_uploadChunked upload: begin
append_game_htmlChunked upload: append a chunk
commit_gameChunked upload: finish and register

Data and config

ToolWhat it doesCredits
read_dataRead GAME_DATA (or one path inside it)
write_dataEdit GAME_DATA at one path (cheap content edit)
bake_configBake a config into the source

Art

ToolWhat it doesCredits
concept_artGenerate concept art for the user to review (design-first)20 each (~40 for the default 2)
generate_assetGenerate an image asset (server-side, zero tokens)20
character_spriteConsistent character sprite (image-to-image; same character, new action)35
prop_packGenerate a PACK of props in ONE image and auto-slice into separate assets (huge credit saver)20
generate_textureGenerate a tileable texture + AUTO normal map (engine II — real depth under lighting)20
generate_coverGenerate a 16:9 cover consistent with the game20
import_assetImport an asset from an image URL (any source)
view_assetLook at an image you generated (check consistency / quality)
review_assetLook at a generated asset and report what you see
list_assetsBrowse the asset library (remember what you generated)
delete_assetDelete injected assets from the game (frees size)

Audio

ToolWhat it doesCredits
generate_soundGenerate a sound effect (real recorded-quality SFX)36
generate_musicGenerate background music (async)20
generate_speechGenerate dialogue / narration speech (text-to-speech)0.5 / s (~3 for 6s)
list_voicesShortlist voices for the user to pick from
take_voicePut the voice the user chose into their own assets

Animation and video

ToolWhat it doesCredits
animated_cgAnimated 16:9 event CG (painted scene, then brought to life)30 / s (~120 for 4s)
sprite_animation2D character animation sprite sheet (image → video → frames)40 / s (~180 for 4.5s)
check_videoInspect a generated video / sprite clip

3D and Live2D

ToolWhat it doesCredits
generate_model_3dGenerate a 3D model (async)300
generate_model_from_imageImage → 3D model (the art-consistent path)750
texture_primitiveApply an AI material to a primitive (AI retexture)250
animate_model_3dAnimate a 3D character (rig + action presets)975 (rig + one action)
generate_live2d_rigGenerate a rigged "Live2D" anime character (portrait → automatic layer decomposition)320
list_3d_libraryBrowse the shared 3D library (admin-curated, FREE to use)
import_model_3dImport a shared-library 3D model into the game (free)
check_model_3dPoll async asset progress (older name — use check_job)

Async jobs

ToolWhat it doesCredits
check_jobPoll any async job (3D model / rig / animation / sprite sheet / audio — auto-injected when done)

Imported game sources

ToolWhat it doesCredits
list_capturesList captured HTML5 game source packages
get_captureInspect a captured game: engine, file inventory, where the logic is
read_capture_fileRead one file out of a captured game package
search_captureSearch inside a captured game package

Playtesting and the editor

ToolWhat it doesCredits
playtest_screenshotPlaytest screenshot (see for yourself how the game looks now)
run_proofReplay GI_PROOF (prove level 1 can be won)
read_edit_requestsRead the requests the user sent from the editor (pull, no listening)
wait_for_edit_requestListen for editor edit requests
finish_edit_requestMark an editor request as done

Next