Skip to content

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.

  • 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.

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

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.