GripForge MCP

gripforge_style_kit

Resolve "Devil May Cry like" / "genshin" to the locker kit already tagged with that game (characters, enemies, weapons, props). Call this before generating.

• promptrequired — e.g. devil may cry like

gripforge_library_list

List the Library locker for the workspace that owns this gf_ key (team locker, not a personal inbox).

• kindoptional — character | enemy | weapon | prop | texture | bind | vfx | animation | audio
• qoptional — Search name
• styleoptional — Game look (devil-may-cry, dmc, genshin)

gripforge_library_get

Get one Library item and its signed file URL.

• idrequired — lib_…

gripforge_library_push

Upload into Library. npm package: local path. Hosted: file_url or base64.

• path / file_urlrequired — Local file (npm) or https URL (hosted)
• kindrequired — character | enemy | weapon | prop | texture | bind | vfx | animation | audio
• nameoptional — Display name

gripforge_library_pull

Sync: write the item into the open repo (npm / Claude Code). Hosted endpoint returns a signed URL only. Also pulls VFX sidecars (tex0..png/json).

• idrequired — lib_…
• out_diroptional — Default ./gripforge-library in cwd

gripforge_library_tag

Add a game look to tags so style_kit finds the item. Does not overwrite grip style melee/gun.

• idrequired — lib_…
• styleoptional — devil-may-cry, genshin…
• tagsoptional — Replace tag list

gripforge_audio_kit

Locker audio for a game look: SFX (sfx_*) and music loops (music_*), grouped, with file URLs. npm out_dir downloads everything. 0 credits.

• promptoptional — Game look (omit for everything)
• out_diroptional — Download files here (npm)

gripforge_generate_character

CREATE a new game-ready mesh (T-pose, auto-rigged) and save it to Library. If the look may already be in the locker, call style_kit first. Put "enemy" in the prompt (or kind=enemy) to save as kind=enemy. 10 credits; 2–8 minutes.

• promptrequired — Description. "Devil May Cry like enemy" → tagged devil-may-cry, kind=enemy
• provideroptional — tripo | meshy (default tripo)
• nameoptional — Library item name
• kindoptional — character | enemy

gripforge_boss

Playable boss kit: stats, phases, attacks bound to anim-pack slots, arena, Three / Godot / Unity / Unreal snippets. 0 credits. Reuses a locker enemy. Pass character_id to bind a mesh. generate=true forges a NEW kind=enemy (10 credits). Then animate + hitbox.

• promptrequired — e.g. devil may cry like phantom boss
• roleoptional — mini | mid | final (inferred from the prompt)
• character_idoptional — lib_… enemy / character / bind — 0 credits
• generateoptional — Forge a new enemy mesh (10 credits). Skip if locker already has one.
• nameoptional — Boss display name
• provideroptional — tripo | meshy (generate only)
• out_diroptional — Write boss.json + snippets (npm)

gripforge_concept_correct

Correct a character concept into a strict T-pose sheet (optional cape/train off, sleeved jacket stays, outfit or sport base). Saves PNG to Library. 1 credit.

• file_url / pathrequired — https image (hosted) or local path (npm)
• clothesoptional — outfit | base (grey athletic sportswear)
• capeoptional — Remove flowing cape/train only; keep sleeved jacket (default true, outfit only)
• notesoptional — Extra direction
• nameoptional — Library name

gripforge_hud

Survivor HUD kit: hud.json + cartoon PNGs + Godot .tscn + Three / Unity / Unreal snippets. Hosted MCP. 1 credit.

• presetoptional — survivor (default)
• health_typeoptional — hearts | bar
• health_maxoptional — 1–20 (default 5)
• health_styleoptional — Built-in skin, or custom:<slug> from hud_bar
• currenciesoptional — default ["gem","mushroom","drop"]
• minimapoptional — default false
• portraitoptional — default true

gripforge_hud_bar

Forge an original themed health-bar frame+fill PNG pair (genre/materials, not a specific game). Hosted MCP. 2 credits.

• themerequired — e.g. gothic demon-hunter, baroque metal
• colorsoptional — Fill gradient [light, mid, dark] hex
• nameoptional — Slug for Library items

gripforge_cape

Cape rig: 3-column bone grid on neck/spine, skins the cape, bakes attached_cape.glb + Godot spring / Three verlet snippets. Hosted MCP. 1 credit.

• character_id / character_urlrequired — Rigged character
• cape_id / cape_urlrequired — Cape mesh
• columnsoptional — Bone columns (default 3)
• rowsoptional — Rows below anchor (default 5)
• saveoptional — Save attached_cape.glb to Library (default true)

gripforge_attach

Auto bone-attach a prop onto a rigged character. Returns bind JSON + Three / Unity / Godot snippets. Bind (+ armed GLB when export_glb) is saved in Library — not a second credit.

• character_path / character_url / character_id / attach_idrequired — Character mesh, Library id, or armed bind (attach_id) as the character
• prop_path / prop_url / prop_idrequired — Prop mesh — local path, https URL, or Library id
• prop_id_2 / prop_path_2 / prop_url_2optional — Second held item (off-hand) attached after the first
• styleoptional — melee | gun | shield | staff
• handoptional — right | left
• height_ratiooptional — Prop size as fraction of body height
• fistoptional — Fist closing amount, 0 open → 1 closed
• export_glboptional — Bake character + fist + prop into attached.glb (mitten rigs)
• out_diroptional — Write bind.json + snippets to this folder (npm)

gripforge_loadout

Multi-weapon character in one call: attaches every prop of every set, names nodes gf_prop_<slug>_<l|r>, stamps a scene manifest { default, sets }, then (default) retargets the clip pack. Engine switches sets by toggling visibility. Credits: one attach per prop.

• character_idrequired — Library character id
• setsrequired — { "sword": [{prop_id}], "guns": [{prop_id, hand, style}, …] }
• default / default_setoptional — Set visible by default (first set otherwise)
• archetypeoptional — sword | claws | heavy | brawler | puppet
• animateoptional — Also retarget the standard clip pack (default true)
• nameoptional — Library name
• out_diroptional — Write loadout.glb + manifest.json (npm)

gripforge_rest_pose

Lower arms against this mesh until they would clip. Saves arms-down rest (weapons stay in the hands on an armed bind). 0 credits.

• character_idrequired — character | enemy | armed bind

gripforge_hitbox

Body capsules + weapons[] (one reach capsule per gf_prop_ wrapper) from a character, armed bind or loadout. Use weapons[] for dual-wield. 0 credits.

• character_idoptional — character | enemy
• attach_idoptional — armed bind
• idoptional — loadout / bind / character

gripforge_formats

List supported mesh formats, styles, and hands. Also reports npm client version vs latest.

gripforge_animate

Retarget the clip pack onto a Mixamo Library character/enemy/armed bind. Base slots + extras (taunt, stinger, knockback, block, jump_*, idle_guns, shoot). archetype remaps base slots. Saves kind=animation. 0 credits.

• character_idrequired — character | enemy | armed bind
• archetypeoptional — sword | claws | heavy | brawler | puppet
• slotsoptional — Subset of idle walk run attack1-3 hit death dodge + extras
• nameoptional — Library name

gripforge_retarget

Convert a clip from skeleton A onto skeleton B. Saves kind=animation.

• source_idrequired — GLB with clips
• target_idrequired — Character to drive
• clipoptional — Clip name (default first)

gripforge_scene_kit

Locker props for a game look plus a suggested layout (metres, Y-up). Empty slots → generate that dressing prop.

• promptrequired — e.g. devil may cry like

gripforge_light_kit

Moon / sun / candle lights + fog + Three.js snippet for a game look. 0 credits. Pair with scene_kit.

• promptrequired — e.g. devil may cry like

gripforge_font

Google-font CSS + exact rank strings (DMC: Cinzel, D–SSS). Put letters in HTML — do not rasterize. 0 credits.

• promptrequired — e.g. devil may cry like

gripforge_navmesh

Walkable XZ AABB + pillar holes for a scene_kit room. JSON clamp, not a baked navmesh. 0 credits.

• promptrequired — e.g. devil may cry like

gripforge_loading_page

Loading overlay for Three / Godot / Unity / Unreal. Title is text. Overlay 0 credits. Pass character_id to generate a 16:9 cinematic still of that Library character (1 credit, no letters in the image).

• promptrequired — e.g. devil may cry like
• character_idoptional — lib_… character / enemy / bind — generate background still (1 credit)

gripforge_level

Plan a playable level from a prompt (0 credits): rooms in metres, connections, critical path, shortcuts, spawns. Same seed → same level. Pair with scene_kit for dressing.

• promptrequired — e.g. gothic castle dungeon, 3 combat rooms, one boss
• seedoptional — Same seed → same layout
• combat_roomsoptional — Number of combat rooms
• floorsoptional — Number of floors
• optional_branchesoptional — Optional side rooms

gripforge_texture_prep

Prep a game texture: optional seamless blend + faithful lanczos upscale (1×/2×/4×, max 1024 or 2048). Pattern preserved — not a generator. Writes the PNG into out_dir (npm) and returns the Library URL. 0 credits.

• path / image_url / texture_idrequired — Local PNG/JPG/WebP (npm), https URL (hosted), or Library id
• seamlessoptional — 50% wrap + seam blend (default true)
• scaleoptional — 1 | 2 | 4
• sizeoptional — 1024 | 2048
• out_diroptional — Write the PNG here (npm). Hosted returns the URL only.
• nameoptional — Library / file name

gripforge_make_seamless

Turn an image into a tileable texture: 50% wrap + seam cross-fade. Pattern preserved. Hosted MCP. 0 credits.

• image_url / texture_idrequired — https URL or Library texture id
• sizeoptional — Force power-of-two side: 512, 1024, 2048
• bandoptional — Blend band as a fraction of the side (default 0.08)
• nameoptional — Library name

gripforge_shaders

List the authorized shader catalog mirrored by GripForge. { id, name, engines: godot|unity|three }. Search aliases like slash_reveal. Free.

• qoptional — Search id / name / alias
• typeoptional — canvas_item | spatial | sky | particles | fog
• limit / offsetoptional — Pagination (default 50)

gripforge_shader_pull

Pull a shader into the open repo (npm writes out_dir; hosted returns file contents). Returns a Godot ShaderMaterial / Unity Material / Three ShaderMaterial assign snippet. v1 pull is free (no credit).

• idrequired — Slug or alias (slash_reveal)
• enginerequired — godot | unity | three
• out_dirrequired — Folder to write into (npm). Hosted: suggested path only.

gripforge_render

Server PNG preview of a Library GLB (agent can see without a browser).

• idrequired — lib_…
• width / heightoptional — PNG size

gripforge_vfx

Admin only. Generate + export 3D slash/thrust/spin VFX on a Library bind, or a world-space fire meteor. Additive PNG, vfx.json + snippets. Refused for non-admin keys.

• attach_idoptional — Library bind (not required for meteor)
• promptoptional — Fills type/style/color/emitters when omitted
• typeoptional — slash | thrust | spin | meteor | beam | swing | claw | charge | shield
• styleoptional — energy | metal | magic
• lookoptional — beam: toon | solid
• coloroptional — Hex color
• durationoptional — Seconds (default 0.25)
• widthoptional — Ribbon width in metres
• out_diroptional — Write vfx.glb + additive.png + snippets (npm)

gripforge_vfx_preview

Admin only. Evaluate the VFX timeline at time t (t=0 empty). No credits.

• bindrequired — Attach bind.json object
• toptional — Seconds (default 0)
• typeoptional — Same types as gripforge_vfx
• durationoptional — Seconds