Sculkwire
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Sculkwire gives your AI agent the Bedrock docs, a validator, a test server and the real game. The agent can write an add-on, check it, run it and watch it work.
Features
Knowledge. Looks up docs, Script API, components, commands, Molang, vanilla examples and changelogs for stable and preview.
Validation. Reports each problem with its file, line and rule.
Test server. Runs your packs and GameTests on a Bedrock Dedicated Server.
Live game. Starts the real game in a test world with your packs, reloads after edits, reads the log and takes screenshots. Works on Windows and Linux.
Player control. The agent walks, finds paths, fights mobs, crafts, smelts, trades and works toward goals like a player.
Game files. Unpacks the vanilla packs from your installed game so you can search or compare them.
In-game agent. An optional helper inside the game. It lets the agent run commands as the player, take screenshots, read inventories, use menus and crafting stations, and pause or step game time. See In-Game Agent.
Extensions. Add your own tools and commands. See Extensions.
Benchmarks.
sculk benchmeasures the agent's combat, movement, goal and task skills in the real game. See Bench.
Related MCP server: minecraft-agent-body
MCP Tools
Category | Tools |
Knowledge |
|
Validation |
|
Server |
|
Game |
|
Player |
|
Containers and Crafting |
|
Engine |
|
Game Files |
|
Setup |
|
The tool reference explains each tool and its inputs.
Quick Start
You need Node.js 22.18 or newer and git. Both install paths give you a sculk command and register sculkwire with your MCP client.
Install With Your Agent
Paste this into your AI agent harness:
Install the sculkwire MCP server: clone https://github.com/Sculkwire/sculkwire.git and follow the "Agent Install" steps in its docs/install.md.The agent installs sculkwire, registers it and runs sculk doctor.
Install With a Script
Linux and macOS:
git clone https://github.com/Sculkwire/sculkwire.git
cd sculkwire
./install.shWindows (Windows PowerShell 5.1 or PowerShell 7):
git clone https://github.com/Sculkwire/sculkwire.git
cd sculkwire
.\install.ps1The installer asks which MCP clients to register with.
--yes (-Yes in PowerShell) skips the question. Other options are in Install and Update.
Or install in one line:
curl -fsSL https://raw.githubusercontent.com/Sculkwire/sculkwire/main/install.sh | shirm https://raw.githubusercontent.com/Sculkwire/sculkwire/main/install.ps1 | iexRun sculk doctor any time. It lists each problem on your machine with a fix.
Manual Setup
To run from a git checkout, run npm install in the clone and add this to your MCP client config:
{
"mcpServers": {
"sculkwire": {
"type": "stdio",
"command": "node",
"args": ["/path/to/sculkwire/src/cli.ts", "mcp"]
}
}
}A git checkout never updates itself.
The first knowledge request downloads docs and samples. This takes about a minute. Run sculk knowledge update to do it ahead of time.
Updating
An installed sculkwire updates itself, at most once a day, in the background.
The new version starts with your next session.
Docs, typings, samples and the test server also update on their own. Offline, the last copy keeps working.
sculk update --check # Show whether a newer release exists
sculk update # Install the newest release now
sculk update --rollback # Switch back to the version before the last update
sculk update --channel off # No automatic updates (release and main are the other channels)Details are in Install and Update.
Requirements
Feature | Requirement |
Knowledge and validation | Node.js 22.18 or newer |
Test server | Windows or Linux x64. You accept the Minecraft EULA |
Game client | Minecraft Bedrock for PC (GDK). Linux also needs gamescope and xdotool. See Game Client Setup |
In-game agent (optional) | The game running. sculkwire downloads the helper, or builds it if you have Rust. See In-Game Agent |
Game files | An installed PC (GDK) copy of the game. See Game Client Setup |
CLI
Most tools also have a command; sculk --help lists them. Installed, the command is sculk. In a git checkout, use node src/cli.ts instead.
Tools that work on state the MCP server keeps between calls have no command: bds_session_*, script_profile, game_launch and the tools on the client it launched (game_command, game_reload, game_query, game_registry, game_screenshot, game_input, player_act, player_job, player_state). sculk game check runs a whole launch in one command instead. command_lookup, molang_lookup, vanilla_example and validate_file have no command either.
sculk validate path/to/addon # Exit code 1 when errors are found
sculk bds gametest path/to/addon # Run GameTests
sculk game check path/to/addon --screenshot shot.png
sculk api Entity.applyDamage
sculk bench combat --runs 3 # Measure the player skills
sculk doctor # Check the machine
sculk --help # List all commandsWith the game running, these commands use the in-game agent. Each prints JSON.
sculk engine attach # Load the in-game agent and print its status
sculk engine status|command|tick|screenshot|player
sculk game lock [on|off|auto] # Keep your input out of the game; F9 takes over
sculk game settings [list|get <id>|set <id> <value>]
sculk world settings [get|set ...]
sculk game ui [screen|controls|press|key|text|click|scroll]
sculk player inventory
sculk container get <x> <y> <z>
sculk craft match|run
sculk interact block <x> <y> <z> | interact entity <id>
sculk screen state|move|act|closeContributing
See CONTRIBUTING.md for setup, checks and where new code goes. Work on the in-game agent starts with Reverse Engineering the Game.
Data Sources
Vanilla samples,
@minecraft/*typings, Microsoft Learn docs, changelogs and Bedrock Dedicated Server are downloaded into your local cache.rockide/schemas by the Rockide project provides the JSON schemas used by the validator and
component_lookup.Packs unpacked from your installed game stay in your local cache.
The icon is a pixel-art sculk block with a glowing pixel Model Context Protocol mark above it.
The social preview image (
assets/social-preview.png) is set in Departure Mono by Helena Zhang (SIL Open Font License).
License
MIT, see LICENSE.
NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Generate game-ready 3D models, textures, and audio from natural language, over MCP.
A registry of AI agent tools — MCP servers, APIs, CLIs, SDKs — kept current by automated ingestion.
Build, validate, and deploy multi-agent AI solutions from any AI environment.
Load saved packs of agent skills and MCP servers with one command; search 1,000+ AI agent tools.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables natural language management of Minecraft Bedrock Edition servers through AI assistants. Supports server lifecycle operations, player/world management, backups, add-ons, and automated tasks via the Bedrock Server Manager API.1-
- AlicenseBqualityCmaintenanceEnables AI agents to operate a Minecraft Java Edition player through MCP, supporting movement, mining, crafting, combat, inventory, and chat with structured observations and action results.18MIT
- AlicenseNot gradedqualityBmaintenanceEnables agents to control and observe a Minecraft client through tools for state, entities, commands, chat, recording, waiting, and event replay, bridging any agent runtime to the game.MIT

HeadlessMc MCPofficial
AlicenseNot gradedqualityBmaintenanceEnables AI agents to install, launch, and control Minecraft: Java Edition clients and servers, including multiple headless instances with isolated profiles. Agents can read the screen and game state, click buttons, type, chat, run commands, join servers, and read logs or send console commands to servers.9MIT