Embers: Tabletop RPG Toolkit

Create a world page

imagine_create_world_page

Create a new page inside a world. Required: worldId, name. Use this for NPCs, locations, organizations, events. Valid documentType values: generic, character, location, organization, event, lore, religion, cosmology. Items and rules are NOT page types; author them in vault and reference them, not as world pages. Set the tags array so the page is filterable via imagine_list_world_pages_by_tags; the page's documentType is also auto-added to the searchable keyword set. Pass visibility: 'gm' for a GM-only page (invisible to non-contributors: 404s, absent from lists) or visibility: 'masked' for a page that participates in lists and backlinks under maskName ('Redacted' when unset) with its real name, link, and content hidden until revealed.

Input Schema

TableJSON Schema

Name	Required	Description
`link`	No	URL-safe slug. Lowercase letters, numbers, hyphens, slashes.
`name`	Yes	Page name. Required.
`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.
`worldId`	Yes	World to add the page to.
`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
`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.

Changed31 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 / 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 / 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. Required.",
+  "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 / properties / worldId

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

addedInput schema / required

Added value: +[
+  "worldId",
+  "name"
+]

First observedSep 21, 2026

TDQS

A4.9/5.0

Behavior5/5

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

It reveals non-obvious behaviors beyond the annotations: gm pages 404 for non-contributors and vanish from lists, masked pages still appear under maskName with hidden content, and documentType is auto-added to the keyword set. Since annotations only establish that this is a non-read-only, non-idempotent world operation, this behavioral detail is valuable and not contradicted.

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

Conciseness5/5

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

The description is dense but every sentence earns its place: required fields and purpose first, then valid types, then tag behavior, then visibility semantics. Despite covering a 28-parameter tool, it avoids fluff and does not repeat parameter names for their own sake.

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

Completeness5/5

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

For a create operation with complex visibility behavior and an output schema, the description covers the substantive choices an agent must make: page category, required identifiers, tag/filter behavior, and public/gm/masked visibility. The optional nested fields remain discoverable in the schema, so no critical guidance is missing.

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

Parameters4/5

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

With schema coverage at only 46%, the description compensates by spelling out the decision-critical parameters (required worldId and name, documentType values, tags filtering, visibility modes and maskName default). It does not explain many optional fields (parentId, outboundLinks, eventDate, menu fields, etc.), though those are less decision-critical for a create call.

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?

Opens with a precise verb and resource ('Create a new page inside a world'), then narrows the scope with concrete use cases (NPCs, locations, organizations, events) and an explicit list of valid documentTypes. It clearly differentiates world pages from the vault-item/rule authoring path and, by naming the world context, from adventure-page siblings.

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?

The description states exactly what the tool is for ('Use this for NPCs...') and gives an explicit when-not: 'Items and rules are NOT page types; author them in vault and reference them.' It also tells the agent to set tags for downstream filtering and explains how to achieve GM-only vs masked visibility, so an agent can decide correctly before invoking.

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?