# GrowBlocks Dev Kit

> GrowBlocks Dev Kit is a free MCP server for games and play. Build, play-test and ship three.js browser games on GrowBlocks from Claude or Cursor. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, API, Web
- **Website:** https://growblocks.xyz/devkit.html
- **Repository:** https://github.com/gioluan/growblocks-devkit
- **MCP Registry name:** xyz.growblocks/growblocks
- **Categories:** games and play, developer tools
- **Listing updated:** 2026-11-14

## About

GrowBlocks games are plain JavaScript on top of the platform's engine, which uses three.js rendering and Rapier physics, with characters, multiplayer rooms and a wallet already in place. The MCP server lets an assistant scaffold a game folder, read the API docs, and then play the game headless with scripted input, returning screenshots plus frame rate, draw calls and triangle counts so it can fix what looks wrong.

From there it can push an unlisted test build for a shareable link. Going public means submitting the game for review, which only happens when you ask. Extra tools prepare 3D models, run headless Blender scripts and check voxel art. Money matters such as collections, the coin and earnings stay in the browser and never pass through the assistant.

The website describes a revenue share where developers get 70 percent of fees their game generates; it notes this is on a testnet for now.

## Features

- **Headless play-testing:** growblocks_playtest plays the game with scripted input and returns screenshots and performance numbers.
- **Starter kit:** growblocks_new_game creates a game folder from the latest starter.
- **Reusable blocks:** Find, add and publish parts other developers shared.
- **Test builds:** growblocks_push uploads an unlisted build and returns a link.
- **Asset helpers:** Tools pack 3D models, inspect GLB files and build icon sheets.
- **Review gate:** Submitting for review and publishing blocks happen only on request.

## Good for

- Describe a game idea and have an assistant build it
- Check a game visually after each change
- Share an unlisted test link with friends
- Add community-made blocks like checkpoints or boost pads
- Prepare a 3D model so it is game-ready

## Install

### Claude Code (Terminal)

```sh
claude mcp add growblocks -- npx -y growblocks
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "growblocks": {
      "command": "npx",
      "args": [
        "-y",
        "growblocks"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "growblocks": {
      "command": "npx",
      "args": [
        "-y",
        "growblocks"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "growblocks": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "growblocks"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "growblocks": {
      "command": "npx",
      "args": [
        "-y",
        "growblocks"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "growblocks": {
      "command": "npx",
      "args": [
        "-y",
        "growblocks"
      ]
    }
  }
}
```

## Tools

- `growblocks_docs`: Dev Kit API docs or one section
- `growblocks_check`: Static checks, optionally playing the game headless with a screenshot
- `growblocks_new_game`: New game folder from the starter kit
- `growblocks_blocks`: Find published blocks
- `growblocks_block_info`: Details of a block
- `growblocks_add_block`: Add a block to a game
- `growblocks_login`: Sign in with a code confirmed in the browser
- `growblocks_whoami`: Show the signed-in account
- `growblocks_create_game`: Create the game on GrowBlocks
- `growblocks_link_game`: Link a folder to a game
- `growblocks_update_game`: Set name, logo and details
- `growblocks_push`: Upload an unlisted test build
- `growblocks_playtest`: Headless play with screenshots, fps and draw calls
- `growblocks_coin`: Manage the game's coin launch steps
- `growblocks_pack`: Make a 3D model game-ready
- `growblocks_glbinfo`: Inspect a GLB file
- `growblocks_atlas`: Build an icon sheet
- `growblocks_blender`: Run headless Blender scripts
- `growblocks_voxel`: Check and render voxel art
- `growblocks_status`: Show builds, links and review note
- `growblocks_games`: List games
- `growblocks_submit`: Submit a game for review
- `growblocks_publish_block`: Publish a block

## FAQ

### What do I need?

Node.js 18 or later; the server runs with npx growblocks mcp.

### Do I need an account?

Not to start building; pushing builds requires confirming a code in your browser.

### Does the assistant handle money?

No. Collections, the coin and earnings stay in your browser.

### Which clients work?

Claude Code (plugin or MCP server), Claude Desktop (.mcpb), Cursor, Windsurf and others.

### Is GrowBlocks Dev Kit free?

Yes. GrowBlocks Dev Kit is free to use.

### How do I add GrowBlocks Dev Kit to Claude Code?

Run this command in your terminal: claude mcp add growblocks -- npx -y growblocks

### What are the best alternatives to GrowBlocks Dev Kit?

The closest alternatives to GrowBlocks Dev Kit are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/growblocks-dev-kit
