MCP Tools

Quick rating

Community listing page, reviews here may not be monitored by the author.

Report a bug to the author How listings work Are you the author?

MCP Tools

By Mr_PotatoOwner

No reviews yet

Adds MCP support to Minecraft, to allow AIs to interact with the game

Mod Loaders
Minecraft
26.2
Hosting Partner

Want to reach Minecraft players?

We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!

Get in touch

About

Description

Description

This mod adds MCP (Model Context Protocol) support for Minecraft, allowing AIs (eg, ChatBot, Agent, Local Models) to interact with the game, entities and players.

This allows AI models to perform tasks using these tools:
  • get_block
  • get_blocks_area
  • set_block
  • fill_blocks
  • break_block
  • get_biome
  • get_heightmap
  • get_light_level
  • get_player_info
  • teleport_player
  • move_player
  • look_at
  • get_inventory
  • select_hotbar_slot
  • give_item
  • clear_inventory
  • get_nearby_entities
  • spawn_entity
  • interact_with_entity
  • execute_command
  • send_chat
  • get_chat_history
  • get_world_info
  • set_time
  • set_weather
  • scan_surroundings
  • build_schematic
  • build_sphere
  • build_cylinder

In Game Commands

These commands can be used in game to see some info:

  • /mcp status
  • /mcp start
  • /mcp stop
  • /mcp restart
  • /mcp token [show|generate] (Only when Authentication is enabled)
  • /mcp config [port|requireAuth|broadcast|readOnly] [value]
  • /mcp help

Configuration File

minecraft-mcp.json

{
  "enabled": true,
  "port": 25560,
  "host": "127.0.0.1",
  "requireAuth": false,
  "authToken": "",
  "allowCommandExecution": true,
  "allowWorldModification": true,
  "broadcastToChat": true,
  "readOnlyMode": false,
  "maxBlocksPerOperation": 32768
}

Integration

1. Claude (Code & Desktop), VS Code Extensions (eg, Cline, Roo)

{
  "mcpServers": {
    "minecraft": {
      "url": "http://127.0.0.1:25560/sse",
      "transport": "sse"
    }
  }
}

2. Cursor, Codex CLI

{
  "mcpServers": {
    "minecraft": {
      "url": "http://127.0.0.1:25560/sse"
    }
  }
}

3. Antigravity (IDE & CLI), Windsurf, Codeium, VSCodium

{
  "mcpServers": {
    "minecraft": {
      "serverUrl": "http://127.0.0.1:25560/sse"
    }
  }
}

4. Direct HTTP and Custom Scripts/Tools

cURL / Rest

curl -X POST http://127.0.0.1:25560/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_player_status","arguments":{}}}'

Python (Need to use MCP SDK)

import asyncio
from mcp import ClientSession
from mcp.client.sse import sse_client

async def main():
    async with sse_client("http://127.0.0.1:25560/sse") as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()
            tools = await session.list_tools()
            print([t.name for t in tools.tools])

asyncio.run(main())