Minecraft MCP server

minecraft-mcp

🤖 minecraft-mcp lets an AI agent see and run your Minecraft server. Ask Claude “who’s online and where are they?”, “why is the server lagging?”, or “give everyone bread and set the time to morning”, and it answers with real data from your world.

It talks to WorldAPI, a Paper plugin, so it works with any Paper 26.3 server that runs WorldAPI. The token you give it decides what the agent may do.

Русская версия

🎬 Video proof is coming soon.

Who it’s for

• 🛠️ Server admins. “Who’s online and what are they doing?”, “what lags, and what’s in the console?”, “ban the griefer and restart in five minutes with a warning”. Run the server from a chat, without SSH or console commands from memory.
• 🌐 People who build a site or a bot. Let an agent explore the API for you: it knows every endpoint and answers with real data, so you see what to build before you write a line.
• 🧭 New players. Set your name once, and ask “where am I, and is it safe?”, “where’s the nearest village?”, “how do I craft a shield?”, “what should I do next?”. Answers come from your world, not from a wiki.
• 🧑‍💻 Pros. Build, clear entities, edit inventories, wait for events, and script the server in Java, all in plain words.

What you get

• 🧰 59 tools for the server, worlds, blocks, entities, players, leaderboards, recipes, and Java scripts. Related actions share one tool, so the agent picks fast and doesn’t get lost.
• 🎒 Inventories in depth. Ask “what’s the best sword in my chest?” or “which of my books has Mending?”: the agent sees every item’s enchantments, attributes, durability, potion effects, armor trim, and what’s inside shulker boxes and bundles.
• 🔑 Only the tools your token can use. A read token shows 27 tools that only look. WORLDAPIREADONLY=1 hides every write, whatever the token allows.
• 🙋 “Me” means you. Set WORLDAPI_PLAYER, and the agent knows who “I” is.
• ⏳ Live events. The agent can wait for something to happen: “tell me when Steve joins”.
• 📝 Prompts for common jobs: a server health check, a lag hunt, a grief investigation, a new player’s guide, and where a player is.
• 🔌 Every client. Claude Code, Claude Desktop in one click, Cursor, and anything else that speaks MCP, over stdio or HTTP.

Try it live

Moonlands, my hard survival server with friends, runs WorldAPI and lets anyone read it. Point the agent there without a token and ask about a real server:

claude mcp add moonlands -e WORLDAPI_URL=https://minecraft.mairwunnx.com/worldapi/api/v1 -- npx -y @mairwunnx/minecraft-mcp

Join at minecraft.mairwunnx.com. The site has the live map, player stats, and the hall of fame.

Install

You need a server with WorldAPI and a token from it: run /worldapi token create agent in game and pick the scopes. Clients that start the server themselves need Node.js 22 or newer.

Claude Desktop

Download minecraft-mcp-.mcpb from Releases and open it. Claude Desktop asks for the WorldAPI URL, your token, and, if you like, your player name.

Claude Code

claude mcp add minecraft \
  -e WORLDAPI_URL=https://your-server.example.com/worldapi/api/v1 \
  -e WORLDAPI_TOKEN=your-token \
  -- npx -y @mairwunnx/minecraft-mcp

Run /mcp in Claude Code to see the tools.

Cursor and other clients

Any client that starts a server over stdio takes the same block:

Shortened. The full README is on GitHub.