Build, play-test with screenshots, and ship three.js browser games using AI-driven development and headless playtesting.
Also known as Gioluan/growblocks-devkit, growblocks-devkit, growblocks
- Stars
- 0
- Tools
- 23
- Downloads, 30 days
- —
- Latest version
- 1.4.0
- Last commit
- Nov 9, 2026
- License
- —
What is GrowBlocks Dev Kit MCP?
GrowBlocks Dev Kit is an MCP server. Build, play-test with screenshots, and ship three.js browser games using AI-driven development and headless playtesting. It exposes 23 tools, such as growblocks_docs, growblocks_check, growblocks_whoami.
Summary generated from the project's README
About GrowBlocks Dev Kit MCP server
Creating browser-based games using three.js and Rapier physics is possible through this development kit for AI assistants like Claude and Cursor. Developers use the server to write game logic, manage 3D assets, and perform headless playtesting. The system allows an AI to play the game without a visible window, capturing screenshots and performance metrics like FPS, draw calls, and triangle counts to verify changes automatically.
Users can integrate the server via npx in terminal-based clients or by downloading a desktop extension for Claude Desktop. The toolkit includes specialized functions for 3D workflows, such as running headless Blender scripts, inspecting GLB files, and converting voxel art. It also provides access to a library of published blocks that can be added to projects. Once a game is ready, the assistant can push unlisted test builds for sharing before a final submission for review.
What you can do with it
- 1Automated visual debuggingAsk the AI to play the game and check if the visual changes look correct via screenshots.
- 2Performance monitoring during playtestsRequest a headless playtest to analyze frame rates and rendering complexity.
- 33D asset preparationHave the assistant clean up 3D props or inspect model data using headless scripts.
- 4Rapid game prototypingGenerate a new game project structure using a starter kit template.
Written from the project's README. Every use case is checked against a quote from it.
How to install GrowBlocks Dev Kit MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall GrowBlocks Dev Kit MCP in Claude Code
$ claude mcp add growblocks-devkit -- npx -y growblocks mcpInstall GrowBlocks Dev Kit MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"growblocks-devkit": {
"command": "npx",
"args": [
"-y",
"growblocks",
"mcp"
]
}
}
}Install GrowBlocks Dev Kit MCP in VS Code
.vscode/mcp.json
{
"servers": {
"growblocks-devkit": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"growblocks",
"mcp"
]
}
}
}Install GrowBlocks Dev Kit MCP in VS Code CLI
$ code --add-mcp '{"name":"growblocks-devkit","type":"stdio","command":"npx","args":["-y","growblocks","mcp"]}'Install GrowBlocks Dev Kit MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"growblocks-devkit": {
"command": "npx",
"args": [
"-y",
"growblocks",
"mcp"
]
}
}
}Install GrowBlocks Dev Kit MCP in Codex
$ codex mcp add growblocks-devkit -- npx -y growblocks mcpInstall GrowBlocks Dev Kit MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.growblocks-devkit] command = "npx" args = ["-y", "growblocks", "mcp"]
Install GrowBlocks Dev Kit MCP in Gemini CLI
$ gemini mcp add -s user growblocks-devkit npx -- -y growblocks mcpInstall GrowBlocks Dev Kit MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"growblocks-devkit": {
"command": "npx",
"args": [
"-y",
"growblocks",
"mcp"
]
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for growblocks 1.4.0 in an isolated container with no network and no keys. It answered and listed 23 tools.
GrowBlocks Dev Kit MCP tools 23
Read from the server with tools/listgrowblocks_docsRead-onlyThe GrowBlocks Dev Kit API for writing game.js (llms.txt): the contract, every gb.* call, patterns and pitfalls. Read it before writing game code. Pass topic (e.g. "gb.physics", "gb.net", "Pitfalls") to get one section.
growblocks_checkRead-onlyRun the Dev Kit checker on the game folder. play=false: static checks (syntax, unknown gb.* calls, blocked browser APIs, imports, file limits). play=true: also plays the game headless inside GrowBlocks for some seconds, reports every runtime error and returns a screenshot. Run it after every change; fix everything it reports.
growblocks_whoamiRead-onlyWho the GrowBlocks CLI is signed in as, and how many games they have. Fails with "Not signed in" if login is needed.
growblocks_loginActionStart signing in to GrowBlocks. Returns a link and a code: give both to the human, who opens the link, checks the code, signs in with Google and presses Allow. The sign-in finishes in the background; check it with growblocks_whoami.
growblocks_gamesRead-onlyThe signed-in developer's games: status (draft, in review, live, changes needed), test and live builds with their links, and GrowBlocks' review note.
growblocks_statusRead-onlyThe status of the game this folder is linked to (growblocks.json): builds, links, review state and note, and what to do next.
growblocks_create_gameActionCreate a new game on GrowBlocks and link the folder to it. address: 3-32 lowercase letters, numbers and dashes (its URL, game.html?g=<address>). Ask the human for the name and address first. A logo (WebP, under 22 KB) and a description are needed before submitting.
growblocks_link_gameActionLink the folder to one of your existing games (writes growblocks.json).
growblocks_update_gameActionChange the linked game's name, tagline, description, studio (the name shown after "by"; empty = the developer's account name), players per room or logo.
growblocks_pushActionRun the static checks, then upload the folder as a new test build of the linked game. Returns the unlisted test link to play and share. Does not make anything public. At most 20 uploads per game a day, so push when a change is worth testing.
growblocks_submitActionSubmit the latest test build to GrowBlocks for review (needs a logo and a description). Only do this when the human asks: GrowBlocks plays it and approves it or sends a note.
growblocks_coinActionThe game's coin (any game, no plaza needed): with no arguments its status (none, held, raising on Mosh Trade with the raise's progress, launching, live, failed). name + symbol hold a name and ticker for the game. launch (a number) links a launch the human made on the GrowBlocks launchpad (checked on chain: theirs, carrying the held name). Launching itself is done by the human in the browser, from the game's card on devkit.html (Launch on Mosh Trade): never ask for keys or sign anything.
Show all 23 toolsShow fewer tools
growblocks_blocksRead-onlySearch the GrowBlocks blocks: parts of games other developers published (vehicles, game modes, enemy brains, level kits) that a game can add instead of writing them. Look here before building something common. Pass words to search names, descriptions and tags.
growblocks_block_infoRead-onlyOne block: what it does, its versions (and what it forked), its entry file and which live games use it.
growblocks_add_blockActionAdd a block to the game: copies its files into blocks/<slug>/ and records it in growblocks.json. Then import it from ./blocks/<slug>/<entry> and read its code for how to use it. Do not edit the block files: GrowBlocks recognises the block by them and its author earns from the game (paid by GrowBlocks; the game keeps its 70%). To change one, publish a fork.
growblocks_publish_blockActionPublish the folder as a block. It needs block.json (slug, name, description, entry, tags, and forkOf if it started from another block). Others can then add it, and its author earns from every live game that ships it. Only when the human asks.
growblocks_packActionMake a 3D model game-ready (needs, in the game folder: npm i -D @gltf-transform/core @gltf-transform/extensions @gltf-transform/functions meshoptimizer sharp). mode "prop": dedup, prune, WebP textures (tex, default 512), Meshopt; tris or simplify cut triangles. mode "char": a rigged character, with clips (comma list of other GLBs of the same rig, merged by bone name, Name=file.glb to name one), textures 1024, Meshopt without position quantisation (it breaks skinned meshes). fix_winding flips inside-out meshes (dark in game) and smooths normals. Writes <name>.packed.glb unless out is given; prints sizes and how to load it.
growblocks_glbinfoRead-onlyWhat a GLB holds: triangles (and drawn, with instancing), vertices, draw calls, materials (with baked-lightmap roles), textures with sizes and bytes, skins, clips with lengths, compression; with warnings for the GrowBlocks limits (3 MB a file, Draco/KTX2 not supported, huge textures). No dependencies.
growblocks_atlasActionPut a folder of icon images into one WebP sheet plus a JSON map {icons:{name:[x,y,w,h]}} (a build holds at most 200 files). cell: px per icon (128); cols; key=true keys out a plain background. Needs sharp (npm i -D sharp).
growblocks_blenderActionRun headless Blender (found via BLENDER or the usual install paths) with a GrowBlocks script. op "clean": a generated prop joined, decimated (tris), scaled (size in m along axis), pivot bottom/top/center, textures shrunk (tex). "ao": ambient occlusion baked into vertex colours (dist, rays). "voxelize": cells JSON (cell size, by material|object|kind). "export": a .blend to GLB with every action as a clip and custom properties as extras. "robot": builds a hard-surface robot or mech (bevelled curved armour shells with real panel gaps, drums, pistons, hoses, vents, one locked palette, AO + edge wear in vertex colours) from a design: file = "example:biped", "example:spider", a .py with build(kit) using the gb_mech library (copy an example from blender/) or a .json preset ({"design","palette","colors","params"}); joints are named nodes (pelvis/torso/head, shoulder/elbow/hand/muzzle L+R, hip/knee/ankle/toe L+R, jet0/1; walkers leg/knee/ankle/toe<i>) that animate by rotation and pair with gb.use("gait"). It returns the turnaround sheet (front, 3/4, side, back, close-up, test pose): look at it, fix the design, run again. options: palette (warden|raptor|olive|carbon|pearl), budget (triangles), param ("k=v,k=v"), merge 0 (one mesh per piece). Then growblocks_pack.
growblocks_voxelActionVoxel art by the voxart kit rules (gb.use("voxart"): one locked palette of hue-shifted ramps, the rules every GrowBlocks voxel model is held to). file: a .vox (MagicaVoxel, Scenario Voxels, the toVox() of your generator) or the cells JSON of growblocks_blender voxelize with by "color" (a Meshy/Tripo GLB as voxels). op "check": score 0-100 and the issues (colours, floating pieces, glow share, symmetry for kind "character", speckle, thin tips, voxel budget, readability at 96 px). "fix": snaps to the palette, caps colours, drops floating bits, fills pinholes, cleans speckle (mirror left|right, size "64" or "48x64x32" to resample), writes <name>.fixed.vox. "render": the turnaround sheet. fix and render return the sheet image (front, side, top, three-quarter, 96 px thumb): look at it, change the generator or the options, run again.
growblocks_playtestRead-onlyPlay the game headless (like growblocks_check with play) with scripted input, and get screenshots over time plus the engine's own numbers each second (fps, draw calls, triangles from window.__gbtest). steps: e.g. "click 0.5,0.85; keys KeyW:1500,Space; drag 0.2,0.5>0.6,0.5; state boss; wait 2000" (positions under 1 are a share of the screen; state = a gb.dev.states name). shots: seconds to screenshot at ("3,12"). Returns the summary and the last screenshot; all shots and report.json are in a temp folder it names.
growblocks_new_gameActionCreate a new game folder from the latest starter kit (game.js, play.html, check.mjs, llms.txt, gb.d.ts, this CLI and .mcp.json). Then pass that folder as dir to the other tools.
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachablegioluan/growblocks-devkit is public and reachablegithub.com/gioluan/growblocks-devkit ↗Pass
- Package names this repository as its sourcegrowblocks names gioluan/growblocks-devkit as sourcenpmjs.com/package/growblocks ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-09github.com/gioluan/growblocks-devkit ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from growblocksPass
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubGrowBlocks Dev Kit for Claude, Cursor and other AI assistants
Make a browser game with an AI assistant and ship it on GrowBlocks: three.js, Rapier physics, characters, multiplayer rooms and hosting, with no setup.
The assistant reads the API, writes game.js, plays the game headless and looks at a screenshot after every change, reuses parts other developers published (blocks), and pushes an unlisted test build you can share. Nothing goes public until you submit it and GrowBlocks reviews it.
Install
Claude Code (plugin: tools + skill)
/plugin marketplace add Gioluan/growblocks-devkit
/plugin install growblocks@growblocks
Claude Code (just the MCP server)
claude mcp add growblocks -- npx -y growblocks mcp
Claude Desktop: download growblocks.mcpb from the latest release and open it.
Cursor / Windsurf / any MCP client
{ "mcpServers": { "growblocks": { "command": "npx", "args": ["-y", "growblocks", "mcp"] } } }
Terminal: npx growblocks new my-game, then npx growblocks help.
Then ask: "Make me a GrowBlocks game where frogs race across lily pads", or use the make_game prompt.
Tools
| Tool | What it does |
|---|---|
growblocks_docs |
The Dev Kit API (or one section of it) |
growblocks_check |
Static checks; with play it plays the game headless and returns a screenshot |
growblocks_new_game |
A new game folder from the starter kit |
growblocks_blocks, growblocks_block_info, growblocks_add_block |
Find and add published blocks (their authors earn when your game ships them) |
growblocks_login, growblocks_whoami |
Sign in with a code you confirm in your browser |
growblocks_create_game, growblocks_link_game, growblocks_update_game |
Make the game on GrowBlocks and set its name, logo and details |
growblocks_push |
Upload an unlisted test build and get its link |
growblocks_playtest |
Plays the game headless with scripted input: screenshots over time plus fps, draw calls and triangles |
growblocks_coin |
The game's coin on Mosh Trade: hold a name and ticker, see the raise, open the launch |
growblocks_pack, growblocks_glbinfo, growblocks_atlas |
Make a 3D model game-ready, inspect a GLB, build an icon sheet |
growblocks_blender, growblocks_voxel |
Headless Blender scripts (clean a prop, build a robot), voxel art checked and rendered on the GrowBlocks palette |
growblocks_status, growblocks_games |
Builds, links and the review note |
growblocks_submit, growblocks_publish_block |
Only when you ask: submit for review, publish a block |
Every tool takes dir, the game folder. Prompts: make_game, ship_game. Resources: llms.txt, gb.d.ts.
Money (collections, the coin, earnings) never goes through the assistant: it stays in your browser at growblocks.xyz. Developers keep 70% of the fees their game generates.
Layout
.claude-plugin/marketplace.json: this repo as a Claude Code plugin marketplaceplugins/growblocks/: the plugin (.mcp.jsonrunsnpx growblocks@1.2.0 mcp, pinned so every install runs the reviewed version, plus thegrowblocks-gameskill)desktop/: the Claude Desktop extension; build it withnpx @anthropic-ai/mcpb pack desktop growblocks.mcpbserver.json: the entry for the official MCP RegistryTERMS.md: the Dev Kit terms
The server is one dependency-free file, growblocks.mjs, published on npm as growblocks.
GrowBlocks Dev Kit MCP questions
How do I add GrowBlocks Dev Kit MCP to Claude Code?
Run claude mcp add growblocks-devkit -- npx -y growblocks mcp in your terminal. Add --scope user to make it available in every project.
How do I add GrowBlocks Dev Kit MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does GrowBlocks Dev Kit MCP provide?
It exposes 23 tools, including growblocks_docs, growblocks_check, growblocks_whoami, growblocks_login, growblocks_games.
How can I test my game with an AI assistant?
The assistant can play the game headless and look at a screenshot after every change to verify the game state.
Can I use existing assets in my game?
Yes, you can find and add published blocks created by other developers.
Does the AI handle financial transactions?
No, money, collections, and earnings are handled in your browser at growblocks.xyz and never go through the assistant.
How do I publish my game?
Nothing goes public until you submit it and GrowBlocks reviews it.