MCP setup
The RC tool has its own Model Context Protocol (MCP) server, so an AI assistant can work with a connected RC session: read the chat, look at scripts, check a source for errors, and save a script.
Turning it on
Section titled “Turning it on”- It is off by default. Turn it on in the RC settings. The settings show a token that is made for your installation.
- It listens on
http://127.0.0.1:8790/mcp, on the same computer only. The port can be changed in the settings. - It works only while the RC tool is logged in. Every call runs as the logged-in staff account, through the same checks on the server. It never gives more than the account has.
- A request without the token gets HTTP 401.
Treat the token like a password. Anyone on your computer who has it can act as your staff account over MCP.
Connecting a client
Section titled “Connecting a client”Add an MCP server of type “streamable HTTP” with the address above and the header Authorization: Bearer <token>. How you do it depends on the assistant.
Tools that change live state are marked destructiveHint, so the assistant asks you before it runs them.
| Tool | Kind | What it does |
|---|---|---|
rc_chat_read(limit) |
read | Recent RC chat lines with UTC times, 1 to 200 |
players_list() |
read | Online players, with the fields your rights allow |
levels_list() |
read | The loaded levels view |
server_flags_read(prefix) |
read | server. and serverr. flags by name prefix |
player_flags_read(account, prefix) |
read | A player’s flags (needs the right to view attributes) |
files_list(path) |
read | A folder listing, within your folder rights |
file_read(path) |
read | A file, as text or base64 for binary, up to 4 MiB, within your folder rights |
scripts_list(kind) |
read | The database NPCs, weapons, or classes you can read |
script_read(kind, name) |
read | A script’s source and version |
script_history(kind, name) |
read | The versions of a script |
diagnostics(source, side?) |
read | Compile a source without saving it and return the errors and warnings |
definitions_lookup(name) |
read | The signature and description of a built-in |
script_save(kind, name, source, base_version) |
edit | The same save as in the RC tool, with the same checks and reload |
rc_chat_send(text) |
chat | Send a staff message to the RC chat |
rc_command(command) |
chat | Run an RC chat command |
What MCP never does
Section titled “What MCP never does”There are no tools to warp, kick, or ban players, to edit player or server flags, rights, Server Options, or folder configuration, or to upload or delete files. rc_command refuses commands that map to those actions, including onRCChat commands that a database NPC marks as admin-only by returning "admin" from onRCCommandKind(cmd) (OQ-RC-3).
Results never include secrets. Calls are written to the audit log with via = 'mcp'.
Engine version 0.1.0. Built 2026-11-18.