Connect AI to your Hytale server

The MCP (Model Context Protocol) plugin revolutionizes how you manage your Hytale server. It allows you to connect AI assistants like ChatGPT, Claude, Codex or Gemini directly to your server to automate complex tasks, build structures automatically or manage your server in natural language.

MCP is a standardized protocol that allows AI assistants to communicate securely with external applications. For Hytale, this means your AI can see the server status, place blocks, manage players and execute commands.

Compatible AI Assistants

• Claude (Anthropic) - Anthropic's assistant, excellent for complex tasks
• ChatGPT (OpenAI) - OpenAI's AI, ideal for natural conversations
• Codex - OpenAI application optimized for programming
• Gemini (Google) - Google's AI, performant and versatile

• Automated Building
  Ask the AI to build a castle, house or any structure. The AI calculates the necessary blocks and places them automatically.
• Simplified Administration
  Manage players, check logs, broadcast messages... all in natural language.
• Assisted Moderation
  Monitor server activity and make decisions with AI assistance.
• Development and Testing
  Quickly test game mechanics or configurations without writing code.

• ✔ Hytale Server: A working Hytale server (see our creation guide)
• ✔ WebServer Plugin: The Nitrado WebServer plugin must be installed (mandatory dependency)
• ✔ AI Assistant: An account on Claude, ChatGPT, Codex or Gemini
• ✔ Network: HTTP/HTTPS access to your server from the internet

After the first start, edit the mods/MCP/config.json file to configure authentication tokens and permissions.

{
  "auth": {
    "enabled": true,
    "adminTokens": ["your-admin-token-here"],
    "playerTokens": ["your-player-token-here"]
  },
  "maxBlocksBatch": 1000,
  "adminPermissions": {
    "set_block": true,
    "set_blocks": true,
    "flatten_terrain": true,
    "execute_command": true,
    "list_players": true,
    "send_message": true,
    "broadcast_message": true,
    "get_player_position": true,
    "list_blocks": true,
    "get_server_logs": true,
    "get_world_info": true,
    "give_item": true
  },
  "playerPermissions": {
    "set_block": false,
    "set_blocks": false,
    "flatten_terrain": false,
    "execute_command": false,
    "list_players": false,
    "send_message": false,
    "broadcast_message": false,
    "get_player_position": false,
    "list_blocks": false,
    "get_server_logs": false,
    "get_world_info": false,
    "give_item": false
  }
}

Important Security

Configuration for Codex (OpenAI)

In the Codex application, add an MCP server with the following settings:

{
  "mcpServers": {
    "hytale-server": {
      "url": "http://your-server:port/Top-Games/MCP/mcp",
      "headers": {
        "Authorization": "Bearer your-admin-token"
      }
    }
  }
}

Configuration for Claude Desktop

Add the following configuration to the Claude Desktop configuration file:

{
  "url": "http://your-server:port/Top-Games/MCP/mcp",
  "auth": {
    "type": "bearer",
    "token": "your-admin-token"
  }
}

Configuration for ChatGPT

For ChatGPT, use the OpenAI API with a compatible MCP client or configure via the Custom Actions interface.

Building and Terrain

• Place a block at precise coordinates
• Place multiple blocks in a single operation (up to 1000)
• Flatten a rectangular area at a given height
• Search and list available block types

Player Management

• View list of connected players
• Get a player's position and rotation
• Send a private message to a player
• Give items to a player

Server Administration

• Execute any server command
• Broadcast a message to all players
• View server logs with filtering
• Get information about the current world

Here are the main tools the AI can use via MCP:

Example 1: Build a House

Prompt: "Build me a small wooden house with windows and a door at coordinates X:100, Y:64, Z:200"

Example 2: Prepare Flat Terrain

Prompt: "Flatten the terrain from X:0 to X:50 and Z:0 to Z:50 at height Y:70"

Example 3: Send Welcome Message

Prompt: "Send a welcome message to all new players"