Imagina RPG

Create a new draft version of one of your worlds, cloned from the latest version. Use this before editing a published world: edit the draft, then publish it from the Imagina app.

Remove a SINGLE entry from one of a draft world's object lists by its natural key. Draft-only, same rules as update_world. - list: one of: npcs, playerCharacters, loreBook, codex, additionalInstructions, settings, seededLocations, tables, startingTrackers, beats, beatGroups, goodEnds, badEnds. - match: the natural key of the item to delete (name, or beat/ending id). Errors if nothing matches.

Documentation for this MCP: how the tools work, the editing loop, and a guide to authoring a great Imagina world (what each part of a world is for and how to write it well). Call this before creating or editing a world, and refer back to it while you work.

Inspect the debug turns of one of your journeys on a world you author: the same world-writer debug view you get in the app. Each turn includes the player action, narrative, the world-state changes it made (trackers, NPCs, plot threads, fired beats, revealed lore), player-safe reasoning, dice rolls, the credits it cost you, and percentage-only token stats, plus the latest world state. Raw prompts and tool calls are not included. Only works for your own journeys on your own worlds.

Get the world definition ONE of your journeys is actually running on. A journey freezes the world at the moment it started and never picks up later edits, so when a journey misbehaves this frozen snapshot, not the world you are editing, is what the storyteller reads. Use it with get_journey_debug to explain why a beat did not fire or a tracker went missing. Returns the journey's settings and how its pinned version compares to the world today, plus a _restApi URL for the full snapshot: snapshots are large, so curl that URL into a file and grep/jq the file rather than pulling it into the conversation. Pass fields to inline just a few top-level keys instead. Only works for your own journeys on worlds you author.

Get Imagina's Markdown reference with examples for authored introductions, public world descriptions, fictional texting bubbles, text effects, images, and story beats. Explains introduction-only versus live-narration formatting and which world settings enable features. During play the storyteller already knows enabled syntax. Returns documentation only, with no inputs, world edits, or real message sending.

Get the definition of one of your worlds. Worlds can be large, so prefer get_world_outline first, then fetch only the fields you need here: pass fields: ["npcs", "generalInstructions"] to return just those top-level keys (id, versionId, name are always included; unknown keys are reported in missingFields). Omit fields to get the whole world. The response also includes a _restApi URL that returns the full world JSON for about 5 minutes (curl to a file / pipe to jq). By default the latest version; pass versionId for a specific one.

Performance analytics for one of your worlds: the same numbers as the in-app creator dashboard. Lifetime totals (unique players, journeys, turns, reroll rate, credits earned), a per-day series (journeys, turns, rerolls, new players) over the selected period, and engagement metrics computed over a sample of journeys active within that period (up to the 1000 most recent): average/median turns per journey, a turns-per-journey histogram split into new vs returning players, and model usage share. Earnings over time are lifetime. Also world-page views: lifetime totals plus a period block (views, unique viewers, and the share of viewers who went on to play), with views and uniqueViewers in the per-day series. Signed-in viewers dedup exactly; signed-out ones are counted once per day, so unique viewers is a floor for reach, not a headcount. Your own playtesting is excluded by default; pass includeOwn to count it (the own block always reports what is being left out). Your own page views are never counted at all.

Cheap table of contents for one of your worlds: every top-level field with its size and a short preview (short values verbatim), and every list (npcs, loreBook, beats, ...) with its item count and each item's name/id, a one-line preview, and JSON size. Call this FIRST to see the shape, then read only the fields you need with get_world. Includes a _restApi URL that returns the full world JSON. By default the latest version; pass versionId for a specific one.

List all versions of one of your worlds (newest first), with version number, engine version, changelog, and timestamps.