{
  "markdown": "# @gripforgeai/mcp\n\nAttach weapons & props to rigged characters — from Claude Code, Cursor or any\nMCP client. Thin client for the [GripForge](https://gripforge.ai) API.\n\n## Hosted endpoint (zero install)\n\nNo Node required — point any remote-capable MCP client at:\n\n```\nhttps://gripforge.ai/mcp\n```\n\nAuth: `x-api-key: gf_...` header (or `Authorization: Bearer`). Assets are passed\nas **URLs** (`character_url`, `prop_url`) — Tripo/Meshy download links work\ndirectly.\n\n```jsonc\n// Cursor (.cursor/mcp.json)\n{\n  \"mcpServers\": {\n    \"gripforge\": {\n      \"url\": \"https://gripforge.ai/mcp\",\n      \"headers\": { \"x-api-key\": \"gf_...\" }\n    }\n  }\n}\n```\n\n## Example\n\n> \"Attach this sword to my knight, right hand, then export the armed GLB.\"\n\nThe agent calls `gripforge_attach` with the two asset URLs (or local paths with\nthe npm package); GripForge finds the hand bone, scales the prop to the\ncharacter's hand, closes the fist around the grip and returns the bind JSON,\nready-to-paste Three.js / Unity / Godot snippets, and optionally the armed GLB.\n\n## Install (Claude Code)\n\n```bash\nclaude mcp add gripforge -e GRIPFORGE_API_KEY=gf_... -- npx -y @gripforgeai/mcp\n```\n\nOr in `.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"gripforge\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@gripforgeai/mcp\"],\n      \"env\": { \"GRIPFORGE_API_KEY\": \"gf_...\" }\n    }\n  }\n}\n```\n\nGet a free API key at https://gripforge.ai/login — the free plan includes **3 API/MCP attaches per month** to try it out (plus 15 in the web Studio). Paid plans from €29/mo for production use.\n\n## Install (Grok)\n\n```bash\ngrok mcp add gripforge --env GRIPFORGE_API_KEY=gf_... -- npx -y @gripforgeai/mcp\n```\n\nOr in `~/.grok/config.toml`:\n\n```toml\n[mcp_servers.gripforge]\ncommand = \"npx\"\nargs = [\"-y\", \"@gripforgeai/mcp\"]\nenabled = true\nstartup_timeout_sec = 45\n\n[mcp_servers.gripforge.env]\nGRIPFORGE_API_KEY = \"gf_...\"\n```\n\nAlso works with Cursor, Windsurf and any MCP-compatible client — same\n`command` / `args` / `env` triple.\n\n\n## Tools\n\n- `gripforge_style_kit` — resolve \"Devil May Cry like\" / \"genshin\" to locker ids\n  already tagged with that look. **Call this before generating.** Reuse the ids.\n- `gripforge_generate_character` — new T-pose + auto-rig into Library (10 credits).\n  `kind=enemy` or the word \"enemy\" in the prompt. Skip this if style_kit already\n  returned a character.\n- `gripforge_concept_correct` — concept image → strict T-pose sheet (1 credit).\n- `gripforge_attach` — character + prop (paths or Library ids) in, bone-local bind + Three.js / Unity /\n  Godot snippets out. Styles: melee, gun, shield, staff (scythe/polearm).\n  With `export_glb: true` (+ `out_dir`) it also writes `attached.glb`: the\n  character with the fist closed and the prop attached, textures preserved —\n  use this for mitten-hand rigs, whose closed fist cannot travel in a JSON bind.\n- `gripforge_formats` — supported formats & options.\n- `gripforge_library_list` / `get` / `push` / `pull` — the Library locker.\n  `pull` writes bind.json + mesh into the open repo (`out_dir`, default `./gripforge-library`).\n  Saving a bind after attach is not a second credit.\n- `gripforge_texture_prep` — local path or `texture_id` → seamless blend + faithful\n  lanczos upscale (1×/2×/4×, max 1024 or 2048). Writes the PNG into `out_dir` and\n  returns the Library albedo URL. Not a generator. No credit.\n- `gripforge_vfx` / `gripforge_vfx_preview` — strike VFX (admin keys).\n- `gripforge_shaders` — list the authorized shader catalog (`{ id, name, engines }`). Search `q=slash_reveal`.\n- `gripforge_shader_pull` — `id` + `engine` (`godot`|`unity`|`three`) + `out_dir` →\n  write sources into the repo and return an assignment snippet. **v1 pull is free**.\n\n## Env\n\n- `GRIPFORGE_API_KEY` (required) — 1 credit = 1 successful attach\n- `GRIPFORGE_API_URL` (optional) — defaults to https://gripforge.ai\n",
  "bytes": 3839,
  "sha": "5fdb5798efeb40b80ec0891da291a8f21c589dc6c2b4351a163ba5316e5d9257",
  "repo_slug": "gripforgeai/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_gripforgeai_mcp_3838cc0c/readme"
}