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 (seen only by the world's owner, its contributors, and an admin with Admin Mode on; 404 and absent from lists for everyone else) 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

Name	Required	Description
`link`	No	URL-safe slug. Lowercase letters, numbers, hyphens, slashes. Choosing a page link needs Premium, VIP, or admin: without it, create ignores the link and derives one from the name, and an update that changes it is refused.
`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 everyone who does not edit the world (its owner, a contributor, or an admin with Admin Mode on) sees 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, its contributors, and an admin with Admin Mode on — 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 everyone else; 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 everyone who does not edit the world sees 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

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed4 schema fields changedOct 15, 2026

changedInput schema / properties / link / description

Previous value: -"URL-safe slug. Lowercase letters, numbers, hyphens, slashes."New value: +"URL-safe slug. Lowercase letters, numbers, hyphens, slashes. Choosing a page link needs Premium, VIP, or admin: without it, create ignores the link and derives one from the name, and an update that changes it is refused."

changedInput schema / properties / maskName / description

Previous value: -"What non-contributors see instead of the page's name while visibility is 'masked'. Empty renders as 'Redacted'."New value: +"What everyone who does not edit the world (its owner, a contributor, or an admin with Admin Mode on) sees instead of the page's name while visibility is 'masked'. Empty renders as 'Redacted'."

changedInput schema / properties / maskSummary / description

Previous value: -"Optional teaser non-contributors see on the masked page; the real summary and content stay hidden. Max 255 characters."New value: +"Optional teaser everyone who does not edit the world sees on the masked page; the real summary and content stay hidden. Max 255 characters."

changedInput schema / properties / visibility / description

Previous value: -"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'."New value: +"Page visibility. 'gm' pages exist only for the world's owner, its contributors, and an admin with Admin Mode on — 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 everyone else; 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'."

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.3/5.0

Behavior5/5

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

Annotations only declare a non-read-only, non-idempotent, non-destructive open-world mutation. The description goes well beyond that: it explains visibility='gm' yields 404s and absence from lists/search/backlinks, describes masked-page mechanics (maskName default 'Redacted', hidden real name/link/content), and notes that setting a custom page link is gated behind Premium/VIP/admin and otherwise silently ignored. This is rich, non-obvious behavioral context.

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?

Front-loaded with purpose and required fields, then layered detail on documentTypes, tags, and visibility. The dense final sentences on visibility are long but each carries decision-relevant information (404 behavior, mask semantics). Appropriately sized for a 28-parameter tool, though slightly run-on.

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?

An output schema exists, so return values need not be explained. Given the tool's high complexity and partial schema coverage, the description covers the highest-risk semantics (visibility, permissions, documentType constraints). Some lesser parameters lack explanation, but an agent can call the tool correctly on the critical paths.

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 description coverage is mid-range (46%) across 28 params, so the description must add meaning. It does add real value on documentType valid values and prohibitions, the tags→searchable-keyword behavior, and visibility/maskName semantics. However, many parameters (image, active, aliases, details, ruleset, template, menu controls, relationships, outboundLinks, vaultCharacterId, playCampaignCharacters) remain unexplained in both schema and description, so it only partially compensates.

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 a specific verb+resource ('Create a new page inside a world'), lists required fields, and enumerates the intended use cases (NPCs, locations, organizations, events). It actively distinguishes itself from sibling authoring tools by stating items and rules are NOT page types and belong in vault, so an agent can route correctly without opening sibling schemas.

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

Usage Guidelines4/5

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

Gives clear context for when to use it (pages for NPCs/locations/orgs/events), an explicit exclusion (items and rules go to vault), and guidance that tags enable filtering via imagine_list_world_pages_by_tags. It does not address create-vs-update routing or how it differs from imagine_create_adventure_page, but the alternatives it does name are the important ones.

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?