Skip to main content
Glama

Create quest mnemons

create_quest_mnemons

Create Quest mnemons: a header (status, kind, playersCanTick, hook, and giverId / locationId / parentQuestId links) and a body of objectives (with sub-objectives), reward chips, a Markdown background and GM-only gmNotes. The server builds the quest the Argo app shows from these. Do not write objectives or rewards as Markdown; markdown alone becomes the Background. The retired quest board fields (steps, reward rows, issuer*, questStatus) are for quests the migration has not converted — see describe_mnemon_types.questBody. Players may not call this — GM/co-GM only.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
itemsYes
campaignIdYes

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
resultsYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed36 schema fields changed
    • addedInput schema / properties / items / items / properties / background
      Added value: +{
      +  "description": "The Background section, in Markdown.",
      +  "type": "string"
      +}
    • changedInput schema / properties / items / items / properties / expiresAt / description
      Previous value: -"ISO-8601 instant."New value: +"Retired quest board field (ISO-8601)."
    • addedInput schema / properties / items / items / properties / giverId
      Added value: +{
      +  "description": "Who gives the quest: an NPC's entryId or exact title (its Quest giver link). On update an empty string removes it.",
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / gmNotes
      Added value: +{
      +  "description": "GM-only notes, in Markdown. Players never see them.",
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / hook
      Added value: +{
      +  "description": "The one line players see under the title in the quest log. An empty string clears it.",
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / issuerNpcEntryId / description
      Added value: +"Retired quest board field: send giverId."
    • addedInput schema / properties / items / items / properties / issuerText / description
      Added value: +"Retired quest board field: write it into background."
    • addedInput schema / properties / items / items / properties / kind
      Added value: +{
      +  "description": "Main | Side | Personal. Reads as Side when unset.",
      +  "enum": [
      +    "Main",
      +    "Side",
      +    "Personal"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / locationId
      Added value: +{
      +  "description": "Where the quest is given or set: a Location's entryId or exact title. On update an empty string removes it.",
      +  "type": "string"
      +}
    • changedInput schema / properties / items / items / properties / markdown / description
      Previous value: -"Body content as Markdown. Mentions: @[label](mnemon:<entryId>). Images: ![caption](asset:<assetId>@<campaignId>) — upload the asset first."New value: +"The quest's prose in Markdown: its Background when background is not given. Mentions: @[label](mnemon:<entryId>)."
    • addedInput schema / properties / items / items / properties / objectives
      Added value: +{
      +  "description": "The objectives, in order.",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "children": {
      +        "description": "Its sub-objectives, in order. Omitted keeps the ones it has; an empty list removes them.",
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "hidden": {
      +              "description": "true hides it from players, false shows it; omitted keeps what it has (a new one is shown).",
      +              "type": "boolean"
      +            },
      +            "id": {
      +              "description": "The objective to rewrite, as get_mnemon's quest.objectives[].id names it. Omit for a new objective.",
      +              "type": "string"
      +            },
      +            "optional": {
      +              "description": "An optional objective does not count toward the quest's progress. Defaults to false.",
      +              "type": "boolean"
      +            },
      +            "state": {
      +              "description": "open (the default), done or failed.",
      +              "enum": [
      +                "open",
      +                "done",
      +                "failed"
      +              ],
      +              "type": "string"
      +            },
      +            "text": {
      +              "description": "The objective, one line of Markdown. Mentions: @[label](mnemon:<entryId>).",
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "text"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "hidden": {
      +        "description": "true hides it from players, false shows it; omitted keeps what it has (a new one is shown).",
      +        "type": "boolean"
      +      },
      +      "id": {
      +        "description": "The objective to rewrite, as get_mnemon's quest.objectives[].id names it. Omit for a new objective.",
      +        "type": "string"
      +      },
      +      "optional": {
      +        "description": "An optional objective does not count toward the quest's progress. Defaults to false.",
      +        "type": "boolean"
      +      },
      +      "state": {
      +        "description": "open (the default), done or failed.",
      +        "enum": [
      +          "open",
      +          "done",
      +          "failed"
      +        ],
      +        "type": "string"
      +      },
      +      "text": {
      +        "description": "The objective, one line of Markdown. Mentions: @[label](mnemon:<entryId>).",
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "text"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / items / items / properties / parentQuestId
      Added value: +{
      +  "description": "The quest this one belongs to: a Quest's entryId or exact title. On update an empty string removes it.",
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / playersCanTick
      Added value: +{
      +  "description": "Whether players may tick the objectives they can see. Off by default.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / items / items / properties / questStatus / description
      Previous value: -"active | completed | failed."New value: +"Retired: send status."
    • addedInput schema / properties / items / items / properties / relatedLocationEntryIds / description
      Added value: +"Locations the quest involves (entryIds or titles)."
    • addedInput schema / properties / items / items / properties / relatedNpcEntryIds / description
      Added value: +"NPCs the quest involves (entryIds or titles)."
    • addedInput schema / properties / items / items / properties / repeatable / description
      Added value: +"Retired quest board field."
    • changedInput schema / properties / items / items / properties / rewards / description
      Previous value: -"Rewards shown when the quest completes."New value: +"The reward chips, each with its kind."
    • changedInput schema / properties / items / items / properties / rewards / items / properties / amount / description
      Previous value: -"Numeric amount for stack-like rewards."New value: +"How many: coins, experience points, a stack."
    • changedInput schema / properties / items / items / properties / rewards / items / properties / amount / type
      Previous value: -"integer"New value: +"number"
    • addedInput schema / properties / items / items / properties / rewards / items / properties / entryId
      Added value: +{
      +  "description": "item chips: the mnemon entry it links to (entryId or exact title). Not with ruleEntryId.",
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / rewards / items / properties / hidden
      Added value: +{
      +  "description": "true hides the chip from players, false shows it; omitted keeps what it has (a new one is shown).",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / items / items / properties / rewards / items / properties / id
      Added value: +{
      +  "description": "The chip to rewrite, as get_mnemon's quest.rewards[].id names it. Omit for a new chip.",
      +  "type": "string"
      +}
    • changedInput schema / properties / items / items / properties / rewards / items / properties / itemId / description
      Previous value: -"Optional reference to an item entry."New value: +"Retired reward row: a free-text item reference."
    • addedInput schema / properties / items / items / properties / rewards / items / properties / kind
      Added value: +{
      +  "description": "currency | xp | item | other. Makes this a reward chip — send it on every reward.",
      +  "enum": [
      +    "currency",
      +    "xp",
      +    "item",
      +    "other"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / items / items / properties / rewards / items / properties / label / description
      Previous value: -"Display label (e.g. '100 gp', 'Ancient map')."New value: +"What the chip says: an item's name, a favour, a title."
    • changedInput schema / properties / items / items / properties / rewards / items / properties / linkedStepIds / description
      Previous value: -"stepIds and/or subquest entry ids whose completion unlocks this reward."New value: +"Retired reward row: the stepIds or subquest entry ids that unlock it."
    • addedInput schema / properties / items / items / properties / rewards / items / properties / notes / description
      Added value: +"Retired reward row: notes."
    • changedInput schema / properties / items / items / properties / rewards / items / properties / rewardType / description
      Previous value: -"Bucket: Gold | Item | XP | Reputation | etc."New value: +"Retired reward row, without kind: Gold | Item | XP | Reputation …"
    • addedInput schema / properties / items / items / properties / rewards / items / properties / ruleEntryId
      Added value: +{
      +  "description": "item chips: the rules-library entry it links to. Not with entryId.",
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / rewards / items / properties / unit
      Added value: +{
      +  "description": "currency chips: the coin, as the campaign's setting names it (e.g. coin.gp), or free text such as 'gold'.",
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / rewards / items / properties / unitLabel
      Added value: +{
      +  "description": "How the coin reads, e.g. 'Gold piece'.",
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / status
      Added value: +{
      +  "description": "Available | Active | Completed | Failed. Reads as Available when unset.",
      +  "enum": [
      +    "Available",
      +    "Active",
      +    "Completed",
      +    "Failed"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / items / items / properties / steps / description
      Previous value: -"Ordered list of quest steps. Omit to leave empty."New value: +"Retired: the old quest board's steps, for quests the migration has not converted. Send objectives."
    • addedInput schema / properties / items / items / properties / subQuestEntryIds / description
      Added value: +"This quest's subquests (entryIds or titles). Prefer parentQuestId on each subquest."
    • changedInput schema / properties / items / items / required
      Previous value: -[
      -  "title",
      -  "markdown"
      -]New value: +[
      +  "title"
      +]
  2. Changed3 schema fields changed
    • removedInput schema / properties / items / items / properties / blocks
      Removed value: -{
      -  "description": "Initial content blocks (at least one).",
      -  "items": {
      -    "additionalProperties": false,
      -    "description": "A single content block. Image blocks need assetId OR (data + mimeType).",
      -    "properties": {
      -      "assetId": {
      -        "description": "Image block: pre-uploaded campaign asset id.",
      -        "type": "string"
      -      },
      -      "caption": {
      -        "description": "Image block caption.",
      -        "type": "string"
      -      },
      -      "checked": {
      -        "description": "Todo-block checked state.",
      -        "type": "boolean"
      -      },
      -      "content": {
      -        "description": "HTML text content for text-type blocks. Use <b>/<i>/<u>/<a>/<br>/<img> — NOT Markdown.",
      -        "type": "string"
      -      },
      -      "data": {
      -        "description": "Image block: inline base64 data (decoded server-side, max 5MB).",
      -        "type": "string"
      -      },
      -      "filename": {
      -        "description": "Image block filename hint.",
      -        "type": "string"
      -      },
      -      "language": {
      -        "description": "Code-block language hint.",
      -        "type": "string"
      -      },
      -      "mimeType": {
      -        "description": "Image block mime type — required when 'data' is set.",
      -        "type": "string"
      -      },
      -      "type": {
      -        "description": "Block type.",
      -        "enum": [
      -          "paragraph",
      -          "heading1",
      -          "heading2",
      -          "bullet_list",
      -          "numbered_list",
      -          "todo",
      -          "quote",
      -          "code",
      -          "callout",
      -          "divider",
      -          "image"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  },
      -  "minItems": 1,
      -  "type": "array"
      -}
    • addedInput schema / properties / items / items / properties / markdown
      Added value: +{
      +  "description": "Body content as Markdown. Mentions: @[label](mnemon:<entryId>). Images: ![caption](asset:<assetId>@<campaignId>) — upload the asset first.",
      +  "minLength": 1,
      +  "type": "string"
      +}
    • changedInput schema / properties / items / items / required
      Previous value: -[
      -  "title",
      -  "blocks"
      -]New value: +[
      +  "title",
      +  "markdown"
      +]
  3. Changed2 schema fields changed
    • addedInput schema / properties / items / items / properties / rewards
      Added value: +{
      +  "description": "Rewards shown when the quest completes.",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "amount": {
      +        "description": "Numeric amount for stack-like rewards.",
      +        "type": "integer"
      +      },
      +      "itemId": {
      +        "description": "Optional reference to an item entry.",
      +        "type": "string"
      +      },
      +      "label": {
      +        "description": "Display label (e.g. '100 gp', 'Ancient map').",
      +        "type": "string"
      +      },
      +      "linkedStepIds": {
      +        "description": "stepIds and/or subquest entry ids whose completion unlocks this reward.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "notes": {
      +        "type": "string"
      +      },
      +      "rewardType": {
      +        "description": "Bucket: Gold | Item | XP | Reputation | etc.",
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / items / items / properties / steps
      Added value: +{
      +  "description": "Ordered list of quest steps. Omit to leave empty.",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "description": {
      +        "type": "string"
      +      },
      +      "notes": {
      +        "description": "Free-text bullet notes for the step.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "status": {
      +        "description": "Defaults to 'Available' when omitted. Unknown values are coerced server-side.",
      +        "enum": [
      +          "Hidden",
      +          "Available",
      +          "Active",
      +          "Completed",
      +          "Failed",
      +          "TurnedIn",
      +          "Abandoned",
      +          "Expired",
      +          "OnHold"
      +        ],
      +        "type": "string"
      +      },
      +      "stepId": {
      +        "description": "Optional. Server generates a fresh UUID when blank. Provide an existing stepId to reuse linkedStepIds.",
      +        "type": "string"
      +      },
      +      "targetLocationEntryIds": {
      +        "description": "Locations involved in this step.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "targetNpcEntryIds": {
      +        "description": "NPCs involved in this step (entryIds or titles).",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "title": {
      +        "description": "Short label for the step, e.g. 'Talk to the innkeeper'.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "title"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
  4. First observed

TDQS

A4.1/5.0
Behavior4/5

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

Annotations already state readOnlyHint=false, destructiveHint=false, and openWorldHint=false, so the safety profile is covered. The description adds important non-annotation behavior: server-side quest construction, Markdown-to-Background fallback, retired-field handling, and GM/co-GM authorization.

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?

The description is front-loaded with the create action and is densely informative in a single paragraph. It avoids repetition and every sentence carries a rule or warning, though the run-on style could be structured more clearly.

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?

For a complex nested creation tool, the description provides a useful conceptual model (header plus body) and covers permissions, Markdown behavior, and retired fields. Output schema handles return values, but the absence of campaignId/items parameter guidance leaves a small top-level gap.

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?

Top-level schema description coverage is 0%, and the description never mentions the required campaignId or items array parameters. It does add useful field-level semantics (e.g., markdown becoming Background, GM-only gmNotes, retired fields), but it does not fully compensate for the missing top-level parameter documentation.

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?

The description opens with a specific verb and resource ('Create Quest mnemons') and enumerates the header/body components, making clear this is quest creation rather than NPC, lore, or journal creation. It distinguishes the tool from siblings through the quest-specific content and the Create verb, even without naming update_quest_mnemons.

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?

It gives concrete usage rules: objectives/rewards must not be written as Markdown, markdown alone becomes Background, retired fields apply only to unconverted quests, and players may not call it (GM/co-GM only). It does not explicitly route the agent to update_quest_mnemons for edits or spell out create-vs-update alternatives, so it stops short of a 5.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.