Model Context Protocol (MCP) Server Guide

PocketMC provides native support for the Model Context Protocol (MCP), enabling AI assistants like Claude Desktop, Cursor, ChatGPT, and custom LLM agents to orchestrate local Minecraft servers, query live server status, trigger backups, and manage network tunnels directly.

1. Configuration for Claude Desktop / Cursor

Add PocketMC to your claude_desktop_config.json or Cursor MCP settings:

{
  "mcpServers": {
    "pocketmc": {
      "command": "pocketmc-cli",
      "args": ["mcp"],
      "env": {
        "POCKETMC_API_PORT": "25585"
      }
    }
  }
}

2. Streamable HTTP Transport (Remote Agents)

For cloud or remote agent environments, PocketMC supports streamable HTTP MCP transport:

Endpoint: https://pocket-mc-proxy.onrender.com/mcp/v1
Protocol: MCP/1.0 (Streamable HTTP)
Manifest: https://pocketmc.github.io/pocket-mc-website/.well-known/mcp.json

3. Available MCP Tools

• pocketmc_list_instances: Returns all configured server instances with statuses, player counts, and allocated RAM.
• pocketmc_start_instance: Spawns the server process with isolated Adoptium Java runtimes.
• pocketmc_stop_instance: Initiates safe RCON world-save and shutdown.
• pocketmc_get_instance_status: Retrieves real-time CPU %, RAM, TPS, and player lists.
• pocketmc_create_backup: Triggers immediate local and OAuth cloud backup synchronization.
• pocketmc_get_logs: Returns real-time sanitized console output with automated privacy redactions.
• pocketmc_manage_playit_tunnel: Inspects or reconfigures Playit.gg public domain tunnels.