From 4189e3d12c7902dbbfa3432aab96e0ea248dd9b3 Mon Sep 17 00:00:00 2001
From: Perplexity Computer <perplexity@tower.local>
Date: Fri, 27 Mar 2026 23:22:36 +0000
Subject: [PATCH] feat: add MCP tool reference context file

Hermes loads this as session context so the model always has
exact tool names. Prevents mcp_morro hallucination loops.
---
 morrowind/CONTEXT.md | 58 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 58 insertions(+)
 create mode 100644 morrowind/CONTEXT.md

diff --git a/morrowind/CONTEXT.md b/morrowind/CONTEXT.md
new file mode 100644
index 0000000..09dfd25
--- /dev/null
+++ b/morrowind/CONTEXT.md
@@ -0,0 +1,58 @@
+# 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