ModdingControl Protocol
Overview
External control via WebSocket, MCP, and HTTP REST
The nox.control module is Nox's external control system for IDEs, dashboards, CLI tools, and AI agents — all backed by a single operator registry.
WebSocket Protocol
Connect and interact with the WebSocket server. Handshake, permissions, and events.
MCP Integration
Expose operators as MCP tools for AI agents. JSON-RPC 2.0 over HTTP.
HTTP REST API
Simple HTTP endpoints for scripting and debugging.
Creating an Operator
Add custom operators from your own mod. Step-by-step guide.
Transports
| Transport | Port | Path | Auth |
|---|---|---|---|
| WebSocket | 8000 | / | hello handshake + permissions |
| MCP | 8001 | /mcp | Authorization: Bearer token |
| HTTP REST | 8001 | /api/* | Authorization: Bearer token |
Configuration
| Key | Default | Description |
|---|---|---|
settings.control.port | 8000 | WebSocket port |
settings.control.http_port | 8001 | HTTP/MCP port |
settings.control.mcp | false | Enable MCP |
settings.control.token | auto-generated | Access token |