The LorAI MCP server lets an AI agent fully control and automate gameplay in Library of Ruina via game state monitoring, battle automation, UI navigation, static data queries, and debug tools.

Game State & Diagnostics

• health_check — Verify the in-game mod HTTP bridge is online

• get_game_state — Retrieve the full current game state (navigation, progression, floors, inventory, battle info)

• get_state_layer — Fetch a specific layer of game state (e.g. battle, floors, navigation)

• get_battle_units — Get detailed HP, speed dice, hand cards, and emotion level for all battle units

• get_emotion_candidates — List available emotion card choices during RoundEndPhase

• get_stage_info — Get controller state for a specific stage

• get_action_status — Check status of async/deferred actions

Static Data Queries

• get_static_data_list — List all available static game data files (cards, books, enemies, passives, etc.)

• get_game_data_item / get_game_data_items — Retrieve one or multiple items from a static collection by ID

UI Navigation

• navigate — Navigate to a specific UI phase (e.g. Sephirah, Invitation, BattleSetting)

• start_game — Click Continue/New Game on the title screen

• skip_story — Skip the current story or event scene

Battle Automation

• start_battle — Full flow: navigate to stage, auto-select books, prepare and start the battle

• battle_loop — Auto-play an entire battle end-to-end (handles dice, card placement, emotion cards, phase stuck detection, story skips)

• play_round — Play a single battle round (stop dice → auto-play cards → confirm)

• select_emotion_card — Manually select an emotion card by index

• click_battle_result — Click the battle result button after a battle ends

• close_battle_scene — Close the battle scene and return to the main UI

Low-Level / Debug

• act — Execute any raw game action by name

• list_methods / call_method — List or call public methods on game objects via reflection

• kill_all_enemy — Instantly kill all enemy units (debug/cheat)

1. Click on "Install Server".

2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.

3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@LorAI MCP start a battle in Urban Nightmare"

That's it! The server will respond to your query, and you can continue using it as needed.

Here is a step-by-step guide with screenshots.