# 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
