Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
ValheimMCP
Localhost HTTP/MCP endpoint for driving Valheim's console remotely and reading the output. Built for agent-driven (Claude Code) access to game state.
CHANGELOG
Changelog
All notable changes to this project are documented here.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
[0.2.0] - 2026-06-19
Added
get_logMCP tool (andGET /logroute): fetch recent lines from an in-memory log ring buffer on demand — tail the log, including on a dedicated server whoseLogOutput.logisn't directly accessible. Supports incremental polling via acursor/sinceand filtering viacontains/regex. Complements the blockingwait_for_log.LogWatchnow retains a bounded ring buffer of recent formatted log lines (configurable vialog.bufferCapacity/log.defaultLines/log.maxLines).
[0.1.0] - 2026-05-29
Added
- Standalone BepInEx plugin exposing a localhost HTTP endpoint for driving Valheim's in-game console.
- Plain HTTP routes for scripting:
GET /health,GET /commands,POST /command. - Native in-process MCP transport (
POST /mcp, Streamable-HTTP / JSON-RPC 2.0) with tools:run_command,list_commands,health,render_view. - Off-screen camera rendering (
render_view) returning a PNG inline, without touching the player's view. - Dependency-free config at
BepInEx/config/valheimmcp.yml, including anallow/denycommand access-control list.
Known limitations
- Output from commands that print asynchronously (coroutines, e.g. screenshot capture) is not captured — only output printed synchronously during the call.