RoRBridge
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
RoRBridge
Cursor MCP server + companion addon so agents can talk to a live Return of Reckoning client: run Lua /script, dump bags, send chat, and snapshot StockPiler3 — with structured JSON replies.
Transport is file IPC under <game>/logs (same family of tricks as LibQuery). There is no socket API from addon Lua, and loadstring is not available — scripts are executed with SendChatText("/script …").
What's in this repo
Piece | Path |
Addon |
|
MCP server | |
File bridge | |
Host CLI (SP3 / health) | |
Cursor MCP snippet |
Related MCP server: Factorio MCP Server
Requirements
Return of Reckoning client (logged in)
Python 3.10+ on the same machine as the game
Cursor (or any MCP client that can spawn a stdio server)
Setup
1. Install the addon
Copy addon/ into your game AddOns folder so the path is:
<game root>/Interface/AddOns/RoRBridge/RoRBridge.mod
<game root>/Interface/AddOns/RoRBridge/RoRBridge.lua
<game root>/Interface/AddOns/RoRBridge/RoRBridge.xmlPowerShell example (adjust both paths):
$repo = "C:\Users\<you>\Documents\GitHub\RoRBridge"
$game = "C:\Users\<you>\Games\Return of Reckoning"
New-Item -ItemType Directory -Force -Path "$game\Interface\AddOns\RoRBridge" | Out-Null
Copy-Item -Recurse -Force "$repo\addon\*" "$game\Interface\AddOns\RoRBridge\"Reload the UI (or restart the client). Enable the addon if your UI manager lists it.
2. Enable the bridge in-game
Log in, then run:
/rormcp onDisabled by default. Check with /rormcp status. Alias: /rorbridge.
Leave /rormcp off when you are not developing — the bridge has full client Lua authority while enabled.
3. Install Python deps
From this repo:
cd C:\Users\<you>\Documents\GitHub\RoRBridge
python -m pip install -r requirements.txt4. Wire Cursor MCP
Merge mcp.json.example into your Cursor MCP config (user or project), and set:
args: absolute path to this repo’sserver.pyROR_GAME_ROOT: absolute path to your RoR install (folder that containslogs/andInterface/)PYTHONDONTWRITEBYTECODE: keep"1"(see below)
Example:
{
"mcpServers": {
"ror-mcp": {
"command": "python",
"args": [
"C:/Users/<you>/Documents/GitHub/RoRBridge/server.py"
],
"env": {
"ROR_GAME_ROOT": "C:/Users/<you>/Games/Return of Reckoning",
"PYTHONDONTWRITEBYTECODE": "1"
}
}
}
}Restart MCP / Cursor so the server reloads. Confirm with the bridge_health tool, then ping while /rormcp on.
Windows Controlled Folder Access
If the repo lives under Documents, Defender CFA may toast when Python writes __pycache__. The server sets PYTHONDONTWRITEBYTECODE=1 / sys.dont_write_bytecode to avoid that. Keep the env var in your Cursor mcp.json.
MCP tools
Tool | Purpose |
| Game root, status log age, whether addon reports enabled |
|
|
| Run Lua via |
| Inventory backpack dump (addon OnUpdate; no |
| Plain |
| Live StockPiler3 snapshot (settings, plan rows, brew, flasks, buy jobs) |
|
|
Prefer scripts that return a value:
return GameData.Player.nameFor StockPiler3 work prefer dump_sp3 / force_build_sp3 over long run_script bodies (≈1800-char /script cap).
Whenever a tool talks to the game, pass note: a short player-facing sentence. RoRBridge prints [RoRBridge] MCP: … in chat (/rormcp messages off hides it).
Host CLI (no Cursor)
With the game up and /rormcp on:
$env:ROR_GAME_ROOT = "C:\Users\<you>\Games\Return of Reckoning"
python sp3_cli.py health
python sp3_cli.py ping
python sp3_cli.py snapshot
python sp3_cli.py forceProtocol (v1)
Channel | Path | Direction |
Requests index |
| MCP → addon ( |
Script payload |
| MCP → addon (64-char chunks; deleted after each request) |
Results |
| Addon → MCP (UTF-16 TextLog) |
Heartbeat |
| Addon → MCP (UTF-16 TextLog; host uses file mtime) |
Ops: script.run, bridge.ping, bags.dump, chat.send, sp3.snapshot, sp3.force_build.
Slash commands: /rormcp on|off|status|debug|messages|help (alias /rorbridge).
Debug: d("[RoRBridge] …") breadcrumbs are on by default (/rormcp debug off to silence).
Limits / safety
Full client Lua authority while enabled — local stdio MCP only; leave
/rormcp offwhen not developing.Wrapped
/scriptlength capped (maxScriptCommandChars, default 1800). Oversized scripts returnSCRIPT_TOO_LONG.One in-flight request per Cursor tool call (server waits for matching
RequestId).
Spike / tests
See spike/SPIKE.md. Host-side CSV roundtrip (no client required):
cd C:\Users\<you>\Documents\GitHub\RoRBridge
python -m spike.test_csv_roundtripLicense
MIT — see LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Trading MCP server for AI agents, with live market data, account reads and controlled execution.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Persistent memory, hybrid search and a goal graph for AI agents, over stdio or remote HTTP.
JW3.ai remote MCP server for market reads and confirm-gated trading execution.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceEnables AI agents to interact with a running Roblox game client to execute Lua code, inspect scripts, spy on remotes, and more.66 npm216MIT
- AlicenseNot gradedqualityDmaintenanceProvides status, stats, nearby scans, item analysis, screenshots, ghost placement, in-game replies, and drone status for Factorio via stdio JSON-RPC.Apache 2.0
- AlicenseBqualityBmaintenanceEnables AI agents and scripts to inspect objects, call functions, and run Lua in a running UE4SS game via MCP, with no sockets or admin rights required.265MIT
- AlicenseNot gradedqualityBmaintenanceEnables any local MCP agent host to observe and operate a real Stardew Valley game through 28 tools covering world snapshots, screenshots, movement, inventory, menus, buying/shipping, containers, crafting, placing, fishing, combat and save loading. Writes run only through normal in-game flows under a single-writer control lease with ledger-based idempotency, epoch invalidation, fail-safe release on disconnect, and human takeover via web console or hotkey.1MIT