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.
Unreleased
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.