calculate_realm_date
ChatGPTAdd or subtract a bounded amount using the selected Realm's custom in-game calendar. Use the weeks unit for weeks and omit all date parts to start from the Realm's current date.
find_world_path
ChatGPTFind one bounded, deterministic recorded path between two resolved world_entity references in the selected Realm. A multi-hop conclusion remains an inference, not a new fact.
get_campaign_progress
ChatGPTInspect bounded current campaign, quest, and task workflow state in the selected Realm. Use campaigns, quests, or tasks as the view and use status filters for open or terminal work. This is current state, not a Session's selected preparation roster or historical actions. Read the Session source for its saved selection, recap and immutable activity.
get_image
ChatGPTRead the pixels of an authorized Compendium Image for viewing or visual analysis. Copy imageId from search_realm, an image reference, or source metadata. Returns one native image content block and metadata listing the original and saved edits. Defaults to a preview of the original. To inspect a saved edit, call again with its variantId. Preview and thumbnail may generate and cache a display image. Delivery is limited to 2 MiB; use a smaller rendition when an unscaled image exceeds the limit. Search-excluded images are unavailable.
get_realm_date
ChatGPTInspect the selected Realm's custom in-game date and a bounded set of calendar events or sessions attached to it. Omit all date parts to inspect the current in-game date.
get_sessions
ChatGPTSelect bounded Session summaries. Next selects the nearest planned Session today or later in scheduleTimezone. Last selects an explicitly completed Session, ordered by schedule then number. Drafts selects undated planned Sessions. Status describes the schedule; playStatus is planned or done. For what happened in the last Session, read its supplied details for the recap and immutable Quest/task activity. Source context distinguishes current Campaign assignment, saved preparation intent and recorded actions. Activity records workflow decisions rather than fictional-world events. campaignId identifies the current assigned Campaign; get_campaign_progress returns its current state, not the last Session's actions or selected roster.
get_source_content
ChatGPTRead one supported Realm reference with a hard source token budget. Small sources return complete canonical content; large sources return a bounded overview, outline, and typed follow-up hints. Use the exact type and id returned by search_realm, another MCP tool, or an internal referenceList item with contentLookup. Copy the supplied lookup arguments; external references are navigation only.
get_source_outline
ChatGPTBrowse one bounded page of direct children in a source retrieval tree. Cursors are opaque and bound to the authorized Realm, source generation, parent, limit, and token budget. Browsing below a returned node requires its selection token; the complete source is never returned.
get_source_sections
ChatGPTExpand one to four returned source nodes with bounded exact children. A first expansion requires the returned nodeKey and selectionToken; later pages use the returned cursor. Never submit guessed keys.
list_my_realms
ChatGPTList up to 20 of the authenticated user's realms. Use this first to choose a realmId for other tools.
retrieve_realm_context
ChatGPTRetrieve a bounded hybrid evidence set for one literal question. The operation searches and packs exact passages server-side and never returns an entire large source. Query embeddings are cached in the selected Realm; uncached query text is sent to OpenAI for embedding processing.
search_realm
ChatGPTDiscover sources in the selected Realm and receive bounded exact evidence for the query. Configured Realm terms apply automatically while retaining the literal wording. A recognized alias uses its preferred phrase for bounded evidence retrieval. Search results are discovery-only; factual claims may use only evidence.items exactContent. Call list_my_realms first and pass a realmId from its response. This records private search ranking logs and caches query embeddings; uncached query text is sent to OpenAI for embedding processing.
search_source_passages
ChatGPTRetrieve bounded exact passages inside one to five type:UUID references returned by authorized Realm tools. This never serializes a complete large document. Query embeddings are cached in the selected Realm; uncached query text is sent to OpenAI for embedding processing.
summarize_source
ChatGPTReturn complete top-level structural coverage, compact summaries, and exact representative locators for one prepared source without returning its full canonical prose. Use passage and section tools for deeper follow-up research.