How do I install Zandronum?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Zandronum need an API key?

No required environment variable is listed on this record.

What transport does Zandronum use?

Zandronum runs locally over stdio.

When was Zandronum last checked?

Last checked 2026-11-12. MCP server for driving and introspecting a local Zandronum dev build.

Zandronum MCP-Server

Agenten stärken

Diesen Server hinzufügen

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Auf PlugMCP ausführen

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add zandronum-mcp -- npx -y zandronum-mcp@0.6.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "zandronum-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Auf PlugMCP ausführen

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Starten

Server facts

Local

Transport: stdio
Version: 0.6.0
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

zandronum-mcp

Let an AI assistant supercharge Zandronum development from your editor: Write C++ code, ACS, DECORATE, fix bugs, the works.

Setup

Download the engine. Grab the build for your OS from Releases and unzip it anywhere.

Windows: zandronum-mcp-engine-windows-x64.zip.
macOS: zandronum-mcp-engine-macos-x64.zip (Intel build, runs under Rosetta 2).
Linux or a custom build: build it yourself.

Learn how to add MCP Servers to your preferred editor. In VS Code, put this in .vscode/mcp.json (Cursor, Claude Desktop, Windsurf, etc. uses something similar. Go look it up yourself or have your AI agent do it for you)

{
  "servers": {
    "zandronum": {
      "command": "npx",
      "args": ["-y", "zandronum-mcp"],
      "env": {
        "ZANDRONUM_EXE": "C:/path/to/zandronum-mcp-hooks.exe"
      }
    }
  }
}

Point ZANDRONUM_EXE at the zandronum-mcp-hooks.exe or zandronum-mcp-hooks.app you just unzipped, then restart your chat session.

Working on several checkouts at once? You don't need to do anything. The bridge port is derived from the engine path, so each build gets its own port range, each launched engine gets its own -config instead of sharing the one system-wide zandronum.ini, and instance numbers are scoped to your session — one editor window can never drive another's game. Set ZANDRONUM_BRIDGE_PORT only if you want to pin a specific port.

Verify with your preferred AI Agent by asking it, "Is Zandronum MCP loaded?" if it responds positively, then it is wired up.

You're done. You can now ask your agent to start working on the engine or start making mods. Remember, the MCP only works with the custom build of Zandronum you downloaded or built from step 1.

Tools

The server exposes tools (run, ACS, DECORATE, scripts, map & render inspection, saves, process control, etc). Your agent discovers them automatically; for a browsable list see README.tools.md.

Advanced

Building the engine yourself, Linux, launching manually, running the server from source, contributing, etc: docs/ADVANCED.md.

Diesen Server hinzufügen

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Zandronum?

Does Zandronum need an API key?

What transport does Zandronum use?

When was Zandronum last checked?

Documentation

zandronum-mcp

Setup

Tools

Advanced