Embers: Tabletop RPG Toolkit

Update a world page

imagine_update_world_page

Idempotent

PUT updates to one world page by id. Only supplied fields are sent. Caller must have 'edit' on the world page. Imagine REPLACES the content body with whatever you send. To append, fetch the page first with imagine_get_world_page, concatenate, and send the combined body back. REQUIRES baseUpdatedAt: copy updatedAt from a fresh imagine_get_world_page read of this page; a stale or fabricated value is rejected with OUT_OF_SYNC and nothing is written — writing from memory of an earlier read is not possible. Set visibility: 'gm' to make a page GM-only (owner/contributors only; hidden from and 404 for everyone else), 'masked' to keep it participating in lists/backlinks under maskName with the real identity hidden, or 'public' to reveal it. Hidden pages are stripped from the world menu.

Input Schema

TableJSON Schema

Name	Required	Description
`id`	Yes	World page id.
`link`	No	URL-safe slug. Lowercase letters, numbers, hyphens, slashes.
`name`	No	Page name.
`tags`	No	Tag list. Stored as a comma-separated `keywords` string on the wire.
`image`	No
`active`	No
`aliases`	No
`content`	No	Page body in markdown. Imagine renders this verbatim. REPLACED wholesale on update.
`details`	No
`gmNotes`	No	GM-only notes attached to the page.
`ruleset`	No
`summary`	No	Short page summary; capped at 150 characters by imagine.
`maskName`	No	What non-contributors see instead of the page's name while visibility is 'masked'. Empty renders as 'Redacted'.
`parentId`	No	Mongo `_id` of the parent world page (tree structure).
`template`	No
`eventDate`	No	Optional in-world event date for chronology-shape pages.
`menuLabel`	No
`menuOrder`	No
`showInMenu`	No
`visibility`	No	Page visibility. 'gm' pages exist only for the world's owner and contributors — every other viewer gets a 404 and the page is absent from lists, search, backlinks, and breadcrumbs. 'masked' pages participate in lists, tags, backlinks, and breadcrumbs but present maskName/maskSummary and an id-based URL to non-contributors; the real name, link, content, and aliases stay hidden until the page is flipped to public. Hidden pages are barred from the world menu. Default: 'public'.
`maskSummary`	No	Optional teaser non-contributors see on the masked page; the real summary and content stay hidden. Max 255 characters.
`documentType`	No
`isWorldChild`	No
`baseUpdatedAt`	Yes	REQUIRED proof that you are working from the latest version: copy the `updatedAt` value verbatim from a FRESH read of this exact record (use the matching get tool first). Values from memory, from an earlier conversation, or guessed timestamps are rejected with OUT_OF_SYNC and nothing is written. After a successful update, the response carries the new `updatedAt` — use that for any follow-up write.
`outboundLinks`	No
`relationships`	No
`showBreadcrumbs`	No
`vaultCharacterId`	No	Bind this page to a vault character (for character-shape world pages).
`playCampaignCharacters`	No

Output Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed32 schema fields changedSep 25, 2026

addedInput schema / $schema

Added value: +"http://json-schema.org/draft-07/schema#"

addedInput schema / additionalProperties
```
Added value: +{}
```
addedInput schema / properties / active
```
Added value: +{
+  "type": "boolean"
+}
```

addedInput schema / properties / aliases

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedInput schema / properties / baseUpdatedAt

Added value: +{
+  "description": "REQUIRED proof that you are working from the latest version: copy the `updatedAt` value verbatim from a FRESH read of this exact record (use the matching get tool first). Values from memory, from an earlier conversation, or guessed timestamps are rejected with OUT_OF_SYNC and nothing is written. After a successful update, the response carries the new `updatedAt` — use that for any follow-up write.",
+  "minLength": 1,
+  "type": "string"
+}

addedInput schema / properties / content

Added value: +{
+  "description": "Page body in markdown. Imagine renders this verbatim. REPLACED wholesale on update.",
+  "type": "string"
+}

addedInput schema / properties / details

Added value: +{
+  "items": {
+    "additionalProperties": {},
+    "properties": {
+      "label": {
+        "type": "string"
+      },
+      "value": {
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "type": "array"
+}

addedInput schema / properties / documentType

Added value: +{
+  "enum": [
+    "generic",
+    "character",
+    "location",
+    "organization",
+    "event",
+    "lore",
+    "religion",
+    "cosmology"
+  ],
+  "type": "string"
+}

addedInput schema / properties / eventDate

Added value: +{
+  "additionalProperties": {},
+  "description": "Optional in-world event date for chronology-shape pages.",
+  "properties": {
+    "day": {
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "eraId": {
+      "description": "Mongo `_id` reference (24-character hex string).",
+      "minLength": 1,
+      "type": "string"
+    },
+    "label": {
+      "type": "string"
+    },
+    "monthId": {
+      "description": "Mongo `_id` reference (24-character hex string).",
+      "minLength": 1,
+      "type": "string"
+    },
+    "year": {
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    }
+  },
+  "type": "object"
+}

addedInput schema / properties / gmNotes

Added value: +{
+  "description": "GM-only notes attached to the page.",
+  "type": "string"
+}

addedInput schema / properties / id

Added value: +{
+  "description": "World page id.",
+  "minLength": 1,
+  "type": "string"
+}

addedInput schema / properties / image
```
Added value: +{
+  "type": "string"
+}
```
addedInput schema / properties / isWorldChild
```
Added value: +{
+  "type": "boolean"
+}
```

addedInput schema / properties / link

Added value: +{
+  "description": "URL-safe slug. Lowercase letters, numbers, hyphens, slashes.",
+  "type": "string"
+}

addedInput schema / properties / maskName

Added value: +{
+  "description": "What non-contributors see instead of the page's name while visibility is 'masked'. Empty renders as 'Redacted'.",
+  "type": "string"
+}

addedInput schema / properties / maskSummary

Added value: +{
+  "description": "Optional teaser non-contributors see on the masked page; the real summary and content stay hidden. Max 255 characters.",
+  "maxLength": 255,
+  "type": "string"
+}

addedInput schema / properties / menuLabel
```
Added value: +{
+  "type": "string"
+}
```

addedInput schema / properties / menuOrder

Added value: +{
+  "maximum": 9007199254740991,
+  "minimum": -9007199254740991,
+  "type": "integer"
+}

addedInput schema / properties / name

Added value: +{
+  "description": "Page name.",
+  "minLength": 1,
+  "type": "string"
+}

addedInput schema / properties / outboundLinks

Added value: +{
+  "items": {
+    "description": "Mongo `_id` reference (24-character hex string).",
+    "minLength": 1,
+    "type": "string"
+  },
+  "type": "array"
+}

addedInput schema / properties / parentId

Added value: +{
+  "description": "Mongo `_id` of the parent world page (tree structure).",
+  "type": "string"
+}

addedInput schema / properties / playCampaignCharacters

Added value: +{
+  "items": {
+    "additionalProperties": {},
+    "properties": {
+      "campaignId": {
+        "type": "string"
+      },
+      "playCharacterId": {
+        "description": "Mongo `_id` reference (24-character hex string).",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "type": "array"
+}

addedInput schema / properties / relationships

Added value: +{
+  "items": {
+    "description": "Mongo `_id` reference (24-character hex string).",
+    "minLength": 1,
+    "type": "string"
+  },
+  "type": "array"
+}

addedInput schema / properties / ruleset
```
Added value: +{
+  "type": "string"
+}
```
addedInput schema / properties / showBreadcrumbs
```
Added value: +{
+  "type": "boolean"
+}
```
addedInput schema / properties / showInMenu
```
Added value: +{
+  "type": "boolean"
+}
```

addedInput schema / properties / summary

Added value: +{
+  "description": "Short page summary; capped at 150 characters by imagine.",
+  "maxLength": 150,
+  "type": "string"
+}

addedInput schema / properties / tags

Added value: +{
+  "description": "Tag list. Stored as a comma-separated `keywords` string on the wire.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedInput schema / properties / template
```
Added value: +{
+  "type": "string"
+}
```

addedInput schema / properties / vaultCharacterId

Added value: +{
+  "description": "Bind this page to a vault character (for character-shape world pages).",
+  "type": "string"
+}

addedInput schema / properties / visibility

Added value: +{
+  "description": "Page visibility. 'gm' pages exist only for the world's owner and contributors — every other viewer gets a 404 and the page is absent from lists, search, backlinks, and breadcrumbs. 'masked' pages participate in lists, tags, backlinks, and breadcrumbs but present maskName/maskSummary and an id-based URL to non-contributors; the real name, link, content, and aliases stay hidden until the page is flipped to public. Hidden pages are barred from the world menu. Default: 'public'.",
+  "enum": [
+    "public",
+    "gm",
+    "masked"
+  ],
+  "type": "string"
+}

addedInput schema / required

Added value: +[
+  "id",
+  "baseUpdatedAt"
+]

First observedSep 21, 2026

TDQS

A4.5/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Goes beyond annotations by disclosing that content is replaced wholesale, that only supplied fields are sent, that OUT_OF_SYNC aborts the write, and how visibility levels behave (404 for GM-only, maskName for masked). These are behavioral traits annotations do not convey (idempotentHint true doesn't capture replacement semantics). No contradiction.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Packed with warnings but front-loaded with the core action. Some redundancy with schema descriptions (visibility, baseUpdatedAt) makes it slightly longer than necessary, but every sentence serves a purpose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Handles the high-stakes behaviors: replacement, optimistic concurrency, and visibility. The existence of an output schema covers return-value details. However, with 29 parameters and nested structures, it doesn't clarify formats for many fields (e.g., how outboundLinks or playCampaignCharacters are structured) – though the schema's types partially cover that.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema covers the essential traps (baseUpdatedAt, visibility, content replacement) in its own descriptions, and the tool description largely repeats those rather than adding new per-field meaning. It adds the cross-cutting 'Only supplied fields are sent' note commonsensically but does not compensate for the 52% of parameters that lack schema descriptions (e.g., relationships, outboundLinks, menuOrder).

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States 'PUT updates to one world page by id' – a specific verb, resource, and scope that clearly distinguishes it from sibling update tools (imagine_update_world, imagine_update_adventure_page) and the create/delete world-page tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly says to fetch first with imagine_get_world_page before append, lists the edit permission prerequisite, and warns that stale baseUpdatedAt is rejected with OUT_OF_SYNC. This gives the agent clear when-to and when-not-to guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Embers: Tabletop RPG Toolkit tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?