MCP

list_realms

List all realms you have access to, including id, title, cover image, and creator. Supports cursor pagination.

get_realm

Get details for a single realm by id, including its members, settings, and which gardeners are on.

create_realm

Create a new realm owned by you. Requires a title. Optionally turn individual gardeners (entity extraction, quest extraction, description auto-sync) off.

edit_realm

Rename an existing realm or turn its gardeners (entity extraction, quest extraction, description auto-sync) on or off. Requires the Admin role or above.

list_sessions

List sessions for a realm, including id, title, start and end times, and summaries. Supports cursor pagination.

get_session

Get details for a single session by id, including scenes and summary.

get_session_transcriptions

Get the full spoken transcript for a session, with speaker identity and timestamps. Supports cursor pagination.

list_entities

List compendium entities for a realm, including id, name, type, description, and cover image. Supports cursor pagination.

get_entity

Get full details for a single compendium entity, including description, variants, images, relationships, and your personal notes.

create_entity

Create a new entity in a realm's compendium. Requires a name and a valid entity type. Set isPublicToRealm to show it to every current and future realm member, or leave it off and use accessIds to share it with specific members instead. Requires the Collaborator role or above.

edit_entity

Update an existing compendium entity's name, type, description, access, or isPublicToRealm. All fields are optional — only the fields you provide are changed. Requires the Collaborator role or above.

edit_entity_notes

Update your personal notes for a compendium entity. Notes are private to you and not visible to other realm members.

merge_entities

Merge one or more entities into a single surviving entity. The merged entities are permanently deleted, and their History moves to the surviving entity. Notes, relationships, access, and images can each be optionally transferred. Requires the Collaborator role or above.

upload_entity_image

Upload a new image to a compendium entity in one call. Provide the image as base64-encoded bytes; images over 5MB are rejected. The image is added as the newest image on the entity. Requires the Collaborator role or above.

delete_entity

Permanently delete a compendium entity and all of its relationships. This action cannot be undone. Requires the Collaborator role or above.

list_relationships

List all compendium relationships in a realm. Each relationship links two entities with a type and the ids of both entities it connects.

create_relationship

Create a directional relationship between two compendium entities. Set isPublicToRealm to show it to every current and future realm member, or leave it off and use accessIds to share it with specific members instead. Returns an error if an identical relationship already exists. If an identical relationship was deleted earlier, it is brought back with its original id instead. Requires the Collaborator role or above.

delete_relationship

Delete a compendium relationship by id. It disappears from every read but stays in both entities' History, where it can be restored in the app. Requires the Collaborator role or above.

list_notes

List compendium notes for a realm, including id, name, access list, and last-updated timestamp. Note text is not included — use get_note to retrieve the full content. Supports cursor pagination.

get_note

Get full details for a single compendium note by id, including its text content.

create_note

Create a new note in a realm's compendium. Requires a name. Requires the Collaborator role or above.

edit_note

Update an existing compendium note. All fields are optional — only the fields you provide are changed. Restricted to the note's own creator; there is no override for editing someone else's note.

delete_note

Permanently delete a compendium note. This action cannot be undone. Restricted to the note's own creator, or a realm Admin or Owner.

list_quests

List quests for a realm, including hook, goal, reward, tags, status, and linked entities. Supports filtering by status and entityId, and cursor pagination.

get_quest

Get full details for a single quest by id, including its complete step timeline.

save_quest

Create or update a quest. Without a questId, creates a new quest; with one, updates only the fields you provide. Requires the Collaborator role or above.

delete_quest

Permanently delete a quest and its step timeline. This action cannot be undone. Requires the Collaborator role or above.

quest_step

Add, edit, or delete a step in a quest's timeline, chosen with the action field. A quest's status is derived from its steps rather than set directly — add a completed, failed, or abandoned step to finish a quest. Requires the Collaborator role or above.