fvtt-mcp-molten5e: Skill for Claude Code

Start a work session

Bring the Molten-hosted Foundry world up and report its state. This is a thin orchestration skill: the mechanics (waking the sleeping VM and launching the world) are already baked into the bridge — do not re-implement them here. Any tool call triggers the bridge's cold-start path automatically.

How the cold-start actually works (context, not steps)

The headless bridge (src/foundry.ts) handles two distinct cold states on its own, driven by .env config (MOLTEN_MAGIC_URL, MOLTEN_ADMIN_KEY, MOLTEN_WORLD_ID):

1. VM asleep → the bridge GETs the Magic URL to wake the EC2 box.
2. VM up, no world active → the bridge logs into admin /setup and launches MOLTEN_WORLD_ID (game.post({action:'launchWorld', ...})).
3. World booting → it waits for the world to become joinable (~25s for the heavy dnd5e world, plus VM wake time on a fully cold box).

So you don't drive any of this manually. You just make one tool call and the bridge does the rest.

Steps

1. Set expectations, then trigger the boot. Tell the user a cold box can take ~30–60s (VM wake + ~25s world boot), then call mcp__foundry-molten5e__get-world-info. This single call wakes + launches as needed and returns once the world is live. (If the world was already up, it returns immediately.)

2. Report the state. Summarize the result clearly — world title/id, system

   • version, Foundry version, and active users (confirm the MCP-Claude GM bridge user is present, which doubles as a bridge-health check). On a dnd5e 6.x world the same result carries an automation block — mention only what matters for the night: the in-world date/time (calendarNow, when the calendar is enabled), and any switch that is OFF its default (falling or exhaustion automation disabled, auto-Downed on, players allowed the damage / effects trays, bastions on). Change a switch only when asked — configure-dnd5e-settings (it echoes previous → new; a few need a client reload). Advance or set the date with manage-calendar ("advance 8 hours", "it's the 3rd of Mirtul, dawn") — advancing time is what triggers dawn / dusk / day recovery and bastion turns.