Ultima MCP
Connect Your Local Client Files Directly to your AI Assistant!
Ever tried to use ChatGPT, Claude, or Copilot to help you write a script or build an event for your ServUO shard, only to have it completely hallucinate item IDs, tile flags, hues, or map coordinates?
That's because modern frontier AI models have no idea what is actually inside your physical Ultima Online client files. They don't know your custom hues, your modified tile data, your map elevations, or your sound files.
Until now!
Introducing Ultima MCP—a lightweight, local .NET 10 bridge that connects your favorite IDE’s AI assistant directly to your local classic client files (.mul, .uop, etc.) using the Model Context Protocol (MCP) and a fast REST/OpenAPI layer.
That's because modern frontier AI models have no idea what is actually inside your physical Ultima Online client files. They don't know your custom hues, your modified tile data, your map elevations, or your sound files.
Until now!
Introducing Ultima MCP—a lightweight, local .NET 10 bridge that connects your favorite IDE’s AI assistant directly to your local classic client files (.mul, .uop, etc.) using the Model Context Protocol (MCP) and a fast REST/OpenAPI layer.
Bring Frontier AI into Classic Britannia
Ultima MCP acts as a secure local bridge. It allows AI models running in tools like Cursor, VS Code, Visual Studio 2026, or Claude Desktop to physically read and query your live game files in real-time.
Instead of copying and pasting IDs from UOFiddler, you can simply type to your AI:
Instead of copying and pasting IDs from UOFiddler, you can simply type to your AI:
- "Find a weapon tile with 'sword' in the name and tell me its item ID, weight, and tile flags."
- "Inspect the map coordinates at Map 0, (1420, 1630) and tell me if the ground is passable, what static items are stacked there, and what the elevation is."
- "Search for a sound ID that has the word 'dragon' in it so I can use it in my mobile's script."
The AI will query Ultima MCP locally, get the absolute ground-truth data from your client files, and write your C# scripts perfectly the first time.
Beyond Code: A Sandbox for AI-Driven Systems
While Ultima MCP is a game-changer for writing C# scripts in your IDE, the real magic lies in its architectural flexibility. Because your entire game asset framework is exposed as a standardized, lightning-fast local API, you aren't restricted to simple coding help.
This bridge opens the door to creating advanced, external AI-driven tools and autonomous server orchestrators. For example, developers can build systems that feed live map coordinates, elevations, and asset lists directly to local LLMs to dynamically map out, plan, and run complex in-game scenarios safely within the literal, physical constraints of the client data.
Whether you are designing advanced administrative assistants, intelligent mapping tools, or laying the foundation for responsive procedural systems, Ultima MCP provides the deterministic data bridge your AI needs to interact intelligently with your world.
This bridge opens the door to creating advanced, external AI-driven tools and autonomous server orchestrators. For example, developers can build systems that feed live map coordinates, elevations, and asset lists directly to local LLMs to dynamically map out, plan, and run complex in-game scenarios safely within the literal, physical constraints of the client data.
Whether you are designing advanced administrative assistants, intelligent mapping tools, or laying the foundation for responsive procedural systems, Ultima MCP provides the deterministic data bridge your AI needs to interact intelligently with your world.
️ What's Packed Inside?
Ultima MCP exposes almost the entire classic client file surface as clean, model-readable data:
- Tile & Land Data: Deep inspections of item weights, heights, flags (Wet, Impassable, Container, etc.), and names.
- Live Map & Static Inspector: Query map grids, elevations, land textures, and stacked static structures to safely verify coordinate spawns.
- Beautiful Interactive UI: Comes with a built-in, stunning Scalar API Reference interactive dashboard running at http://localhost:5027/scalar for easy manual debugging.
- Multimodal Asset Retrieval: Exposes art, gumps, light masks, and multimaps as PNG endpoints, and sounds as WAV endpoints so you can preview files on demand.
- Deep SDK Coverage: Reads hues, radar colors, fonts, multi structures, cliloc strings, speech files, and animations.
Fast, Safe, and Local-Only
- 100% Read-Only: Ultima MCP never modifies your game files. It uses a writable shadow copy cache in your %LOCALAPPDATA% folder to handle restricted system directories safely.
- Zero Cloud Exposures: Binds strictly to 127.0.0.1 by default with no external interfaces. Your assets and local file system remain completely private to your machine.
- Zero Legacy Boilerplate: Built using modern .NET 10 Minimal APIs and native OpenAPI schemas for maximum speed.
Ready to supercharge your development workflow?
Click the Go to Download button to grab the source code, check out the full step-by-step setup guide, and bridge your shard development into the AI era!
Also check out the Skill tailored to ServUO and uses this MCP!
SevUO Dev Skill
Click the Go to Download button to grab the source code, check out the full step-by-step setup guide, and bridge your shard development into the AI era!
Also check out the Skill tailored to ServUO and uses this MCP!
SevUO Dev Skill
