Hytale MCP Server 🎮

> The ultimate AI companion for Hytale Modding.

This is a Model Context Protocol (MCP) server that gives your AI Assistant (Claude Desktop, Cursor, Windsurf, etc.) deep knowledge about Hytale.

Features ✨

* 📚 Lore Database: Ask about Mobs (Kweebec, Trork), Items (Void Scythe), and Recipes.
* 🛠️ Modding API Docs: Full simulated documentation for the Hytale API (Plugins, ECS, WorldGen).
* 🏗️ Project Scaffolding: Instantly generate build.gradle and hytale.json for new mods.
* 🐛 Error Analysis: Paste a crash log, and the AI will tell you how to fix it.
* 🎨 Asset Templates: Generate JSON for Models and Textures.

Installation 📦

$3

You can run this directly without installing it globally.

Claude Desktop Configuration:
Add this to your claude_desktop_config.json:

``json { "mcpServers": { "hytale": { "command": "npx", "args": ["-y", "hytale-mcp"] } } }`

`$3`

bash
npm install -g hytale-mcp


Then configure your editor to run:

hytale-mcp


Capabilities 🤖
$3

*

search_wiki

: Search the entire knowledge base.
*

get_api_reference: Get code examples for specific topics (e.g., spawning_entities, custom_ui

).
*

scaffold_project

: Generate a new mod project structure.
*

analyze_error

: Diagnose Hytale-specific exceptions.
*

generate_asset

: Create JSON templates for models/textures.
$3

*

hytale://lore/mobs/list

hytale://api/docs/list

hytale://advanced/docs/list

 (WorldGen & ECS)
Development

1. Clone repo 2.npm install3.npm run build4.node build/index.js`