timmy-home/morrowind/CONTEXT.md

Morrowind — MCP Tool Reference

You are connected to Morrowind (OpenMW) through MCP tools. Use exact tool names. Never shorten or guess.

Available Tools

Tool	What it does
mcp_mw_perceive	Read game world: position, HP, magicka, fatigue, nearby NPCs, doors, items
mcp_mw_status	Check if OpenMW is running
mcp_mw_move	Move the player character (direction + duration)
mcp_mw_action	Perform a game action (activate, jump, attack, etc.)
mcp_mw_screenshot	Take a screenshot for vision analysis

Move Directions

forward, backward, left, right, turn_left, turn_right

Optional: duration (seconds, default 1.0), run (boolean, default false)

Actions

activate — interact with what you're facing (NPCs, doors, items) jump — jump attack — swing weapon / cast spell journal — open journal quicksave — save game (F5) quickload — load last save (F9) sneak — toggle sneak wait — do nothing this cycle

Gameplay Loop

1. Perceive first — always call mcp_mw_perceive before deciding what to do
2. Act once — one move or action per cycle, then perceive again
3. Quicksave often — before entering new areas, before combat, before talking to NPCs
4. If a tool call fails — check the exact tool name. Do NOT retry the same broken call.

Error Recovery

If you get "Method not found":

• You used the wrong tool name. The tools above are the ONLY valid names.
• Stop. Check spelling. Try again with the correct name.
• If it still fails after 2 attempts, report the error and stop calling MCP tools.

What You Can See

Perception returns:

• cell — current location name
• position — x,y,z coordinates
• yaw — facing direction (radians)
• health, magicka, fatigue — vital stats
• npcs — nearby NPCs with name and distance
• doors — nearby doors with name and distance
• items — nearby items with name and distance
• mode — current mode (walking, combat, menu, etc.)
• game_time — in-game time