Skip to main content
Glama

Stonecut Map Builder

Website: https://stonecut.studio/resources | npm: https://www.npmjs.com/package/stonecut-map-builder | YouTube: https://www.youtube.com/@StonecutStudios (videos coming soon)

Let your AI agent build Minecraft maps for you. Stonecut Map Builder gives Claude Code (or any agent that supports MCP) its own private Minecraft test server on your computer. The agent sets it up, builds on it, checks its own work block by block, and exports what it made as a schematic you can paste on any server. Free and open source under the MIT license.

Setup

  1. Install Node.js 20 or newer from https://nodejs.org (the LTS download).

  2. Have Claude Code installed and signed in.

  3. Add the tool to Claude Code. If the claude command works in your terminal:

    • macOS and Linux: claude mcp add --scope user stonecut-map-builder -- npx -y stonecut-map-builder

    • Windows: claude mcp add --scope user stonecut-map-builder -- cmd /c npx -y stonecut-map-builder

    If you only use the Claude Code extension in VS Code, claude is usually not on your PATH ("not recognized" / "command not found"). Run the copy bundled with the extension instead:

    • Windows (PowerShell):

      & (Get-ChildItem "$env:USERPROFILE\.vscode\extensions\anthropic.claude-code-*\resources\native-binary\claude.exe" | Sort-Object { [version]($_.FullName -replace '.*claude-code-([\d.]+).*','$1') } | Select-Object -Last 1).FullName mcp add --scope user stonecut-map-builder -- cmd /c npx -y stonecut-map-builder
    • macOS and Linux:

      "$(ls -d ~/.vscode/extensions/anthropic.claude-code-*/resources/native-binary/claude | sort -V | tail -n 1)" mcp add --scope user stonecut-map-builder -- npx -y stonecut-map-builder
  4. Start Claude Code (in VS Code: "Developer: Reload Window"), type /mcp and check that stonecut-map-builder shows as connected.

  5. Paste the setup prompt from docs/setup-with-ai.md. The agent installs the skill (it asks first), asks your Minecraft version and modpack, shows what it will download, and asks you to accept the Minecraft EULA. Nothing is installed without your yes.

  6. It starts the server and gives you an address like localhost:25565. Join it from Minecraft (same version), ask the agent to make you operator, then ask it to build.

Related MCP server: minecraft-mcp-server-blueprint

Example requests

  • "Build a small stone watchtower with a spiral staircase and a lookout on top, next to spawn."

  • "Make a medieval market square with five stalls, a well in the middle and lanterns."

  • "Read back the house you just built and fix anything that looks wrong."

  • "Export the castle as a schematic so I can paste it on my server."

Works with Stonecut Studio

Make a map or a piece on stonecut.studio, download it as a .schem, put it in your test server's folder, and ask your agent to import it. Then keep building on it with your agent: add interiors, change materials, add quests or mobs, and export the result. Big maps are bigger than the tool's import limit by default; download single pieces, or raise maxImportBlocks (see the reference).

What it supports

  • Minecraft Java Edition 1.20.1 and newer, vanilla and NeoForge. More versions and mod loaders are coming.

  • Windows, macOS and Linux. Made for Claude Code; other MCP agents should work.

  • Java for your Minecraft version: Java 17 for 1.20.1 to 1.20.4, Java 21 for 1.20.5 to 1.21.11, Java 25 for 26.1 and newer. The agent tells you if it is missing and where to get it.

Safety

  • The test server only listens on your own computer. Nothing connects to another machine.

  • Server files come only from Mojang and NeoForged, checked against their published hashes.

  • It only works inside the folders you allow. It installs nothing, and clears, replaces or restores nothing, before you say yes.

  • Every change can be undone, and whole-world backups are one request away.

  • Your agent may have other tools, like a shell, that these rules don't cover. Keep your agent's own permission prompts on.

The full rules and every setting are in the reference.

Troubleshooting

Run npx -y stonecut-map-builder doctor. It checks Node, your settings, Java, the test server, the skill and whether the tool starts, and says how to fix each problem. It changes nothing. See the reference.

More

Available Tools

24 tools
accept_eulaRecord that the person accepted the EULAA
Idempotent

Writes eula=true for the active test server. Minecraft needs this to start. Only call it after you showed the person the Minecraft EULA (https://aka.ms/MinecraftEULA) and they said they accept it. Never accept it for them.

Inputs: person_accepted (required).

backup_worldBack up the whole worldA

Copies the whole world folder into the server's own backup folder (the server pauses saving while it copies, so the copy is consistent). Do this before big changes, for example before importing a large map or anything too big for an undo snapshot. The tool never deletes backups.

Inputs: no named parameters.

clear_blocksClear an area to airA
DestructiveIdempotent

Sets every block in the box to air (containers are emptied, nothing drops). With include_entities (default on) it also removes the entities in the box first, without drops; players are never touched. Snapshots the area, entities included, for undo.

Inputs: to (required), from (required), confirm, dimension, +2 more.

copy_blocksCopy an areaA
DestructiveIdempotent

Copies the box from..to so its lowest corner lands at destination (with /clone). skip_air keeps what is already at the destination where the source is air. Snapshots the destination first for undo.

Inputs: to (required), from (required), destination (required), skip_air, +2 more.

create_serverCreate the planned test serverA

Carries out a plan from plan_setup: makes the folder, downloads the server from the official source, checks every hash (nothing is kept if a hash is wrong), runs the NeoForge installer if chosen, and writes server.properties with RCON on 127.0.0.1 and a random password. Does not accept the EULA and does not start the server. Only call this after the person said yes to the plan.

Inputs: plan_id (required), person_confirmed (required).

export_schematicExport an area to .schemA
DestructiveIdempotent

Saves the box from..to as a Sponge schematic (.schem) inside the test server folder, with block states and block data (chest contents, sign text). Version 3 (default) suits WorldEdit 7.3 and newer; use version 2 for older tools. The file can be pasted on any server with WorldEdit or a similar plugin. Entities whose position is inside the box (item frames, paintings, armor stands, mobs, minecarts, boats) are saved with all their data. Limited to maxImportBlocks and maxEntities.

Inputs: to (required), file (required), from (required), confirm, +4 more.

fill_blocksFill boxesA
DestructiveIdempotent

Fills one or more boxes with a block, in order. Boxes over 32768 blocks are split for you. mode: replace (default), hollow (walls, inside cleared), outline (walls only, inside kept), keep (only air is filled), destroy (drops items). replace_only limits it to one block or #tag. Snapshots the area first for undo.

Inputs: fills (required), dimension, skip_backup.

import_schematicImport a .schem into the worldA
DestructiveIdempotent

Pastes a Sponge schematic (.schem, version 2 or 3, as WorldEdit and most editors save) from the test server folder into the world with its lowest corner at origin, including chests, signs and other block data. include_air (default true) clears the area first so the result matches the file exactly. Snapshots the area first for undo. Entities in the file (item frames, paintings, armor stands, mobs, minecarts, boats) are summoned after the blocks, with fresh UUIDs; leads stay tied and riders stay seated. include_air also removes the entities already in the area. Limited to maxImportBlocks and maxEntities.

Inputs: file (required), origin (required), confirm, dimension, +3 more.

list_filesList files in the server folderA
Read-onlyIdempotent

Lists files and folders inside the test server folder, for example world/datapacks, config or mods. Paths are relative to the server folder; nothing outside it can be listed.

Inputs: path, depth.

place_blocksPlace blocksA
DestructiveIdempotent

Places single blocks, up to 10000 per call. The tool packs neighbouring equal blocks into /fill commands, places torches, doors, plants, redstone and liquids after the blocks that hold them, and snapshots the area first so undo can put it back. Later entries at the same spot win.

Inputs: blocks (required), dimension, skip_backup.

plan_setupPlan a test server (changes nothing)A
Read-onlyIdempotent

Looks up everything needed for a new local test server and changes nothing: the exact Minecraft (and NeoForge) version, which Java it needs and whether it is installed, every file that would be downloaded with its official source and hash, the folder and the ports. Show the result to the person and ask before create_server. Minecraft Java Edition 1.20.1 or newer.

Inputs: loader (required), minecraft (required), name, game_port, +5 more.

read_blocksRead the blocks in an areaA
Read-onlyIdempotent

Returns the blocks in a box with their full states, block entity ids and a count per block. The server saves the world first and the tool reads the saved chunks, so it changes nothing. Limited to maxReadBlocks per call (32768 by default, for example 32x32x32); read big builds in parts. format "layers" (default) is compact, one line per row; "list" gives every non-air block as [x, y, z, state].

Inputs: to (required), from (required), format, dimension.

read_entitiesList the entities in an areaA
Read-onlyIdempotent

Lists the entities whose position is inside the box: item frames, paintings, armor stands, mobs, minecarts, boats, items. For each: id, position, rotation, UUID, custom name, what it is tied to (lead) and its data as SNBT (shortened unless full: true). Players are not listed. The server saves first and the tool reads the saved entity files, so it changes nothing. Limited to maxEntities.

Inputs: to (required), from (required), full, dimension.

read_fileRead a file in the server folderA
Read-onlyIdempotent

Reads a file inside the test server folder: configs, datapack files, logs. Use encoding base64 for binary files. The RCON password in server.properties is hidden. Limited to maxFileBytes.

Inputs: path (required), encoding.

restart_serverRestart the test serverA

Stops the server cleanly and starts it again, for example after changing server.properties, datapacks that need a restart, or mods.

Inputs: no named parameters.

restore_worldRestore a world backupA
Destructive

Replaces the world with a backup from backup_world. The server must be stopped. The current world is not deleted: it is moved into the backup folder as replaced-. status lists the backups.

Inputs: name (required), confirm.

run_commandRun a server commandA
Destructive

Runs any Minecraft server command through RCON and returns the reply, for example gamerule, time, weather, summon, give, op, reload, function, scoreboard, team, tp, data. Commands from mods and datapacks work too. Give backup_area to snapshot an area first so undo can put it back; otherwise this cannot be undone.

Inputs: command (required), dimension, backup_area.

server_logsRead the server logA
Read-onlyIdempotent

The last lines of the server log (logs/latest.log), or of the console output if the server failed to start. Optional filter keeps only lines containing that text. The RCON password is hidden.

Inputs: lines, filter.

start_serverStart the test serverA
Idempotent

Starts the active test server in the background and waits until RCON answers (the first start makes the world and can take a minute or two). Before starting it puts back the settings the tool depends on: listen on 127.0.0.1 only, RCON on, no query port. The person then joins in Minecraft at localhost:.

Inputs: no named parameters.

statusStatus and settingsA
Read-onlyIdempotent

Call this first. Shows the person's safety settings (config file, allowed server folders, size limits, file and mod rules), the active test server (version, folder, running or not, ports, EULA), Java found on this computer, the undo history and world backups.

Inputs: no named parameters.

stop_serverStop the test serverA
Idempotent

Stops the test server cleanly through RCON (the world is saved) and waits for it to exit. force: true ends the process if it does not answer; unsaved changes may then be lost.

Inputs: force.

undoUndo the last changeA
Destructive

Puts back the area changed by the most recent change (place, fill, copy, clear, import, or run_command with backup_area), from the snapshot taken before it: blocks, and entities when the snapshot has them (entities added since are removed, removed ones are summoned again). Call again to go further back; status lists what can be undone.

Inputs: confirm.

use_serverSwitch to another test server folderA
Idempotent

Makes another server folder the active one. It must be inside one of the allowed server folders in the person's config (see status). A server this tool did not make is adopted: the tool works out how to start it and keeps its settings, except that it always keeps RCON on 127.0.0.1.

Inputs: folder (required).

write_fileWrite a file in the server folderA
DestructiveIdempotent

Writes a file inside the test server folder, making folders as needed: datapacks (world/datapacks/...), configs, server.properties. Mods (.jar files and the mods folder) only if the person allowed it (allowModInstall). The world's chunk files, level.dat and eula.txt cannot be written. After writing server.properties the tool keeps RCON on 127.0.0.1. Use encoding base64 for binary files. Limited to maxFileBytes.

Inputs: path (required), content (required), confirm, encoding, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 24 tools

    Disambiguation4/5

    Each tool targets a distinct resource+action: server lifecycle (create/start/stop/restart), file I/O, backups vs undo, and world editing are clearly separated. The only places an agent could hesitate are place_blocks vs fill_blocks (single blocks vs boxes) and copy_blocks vs import_schematic, but the descriptions make the boundaries explicit.

    Naming Consistency4/5

    Almost everything follows verb_noun (read_file, backup_world, start_server, place_blocks, import_schematic). Deviations are the singleton-style names 'undo' and 'status', plus 'server_logs' (noun-first where 'read_logs' would fit) and 'plan_setup' sitting oddly next to 'create_server'.

    Tool Count4/5

    24 tools is on the heavy side but the surface splits into coherent groups (server lifecycle, file access, backup/undo, block editing, schematic import/export) and each tool has a distinct job. A couple could arguably merge (place_blocks into fill_blocks), keeping it just short of ideal scoping.

    Completeness5/5

    Full lifecycle is covered: plan/create/EULA/start/stop/restart, logs and RCON commands, file read/write, backup/restore/undo, plus a complete world-edit loop (read_blocks, read_entities, place, fill, copy, clear, import/export schematic). No obvious dead ends for building or operating a test server.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to perceive, navigate, interact with, and build inside Minecraft through typed, bounded operations, including deterministic blueprints, verified builds, repair, and creative-mode flight or teleport. Runs as a provider-neutral MCP server or an interactive dev shell, exposing movement, voxel manipulation, inventory, chat, and diagnostics tools.
      3
      Apache 2.0