Servers Playground How we check Add a server Log in

Argo Mcp

Working · 2.4 s

io.github.Argo-RPG-Platform/argo-mcpv1.0.3

MCP server for Argo RPG Platform — connects AI assistants to campaign data via OAuth2

Entertainment & Games

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.argo.games/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

accept_friend_request

Accept an incoming friend request from the given user.

userIdstring, required

Argo user ID of the counterparty.

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Argo Mcp MCP server | mcptry

Argo Mcp

Working · 2.4 s

io.github.Argo-RPG-Platform/argo-mcpv1.0.3

MCP server for Argo RPG Platform — connects AI assistants to campaign data via OAuth2

Entertainment & Games

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.argo.games/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

accept_friend_request

Accept an incoming friend request from the given user.

userIdstring, required

Argo user ID of the counterparty.

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (65)

accept_friend_request

Accept an incoming friend request from the given user.

Argument	Type	Description
userId*	string	Argo user ID of the counterparty.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "userId"
  ],
  "properties": {
    "userId": {
      "type": "string",
      "minLength": 1,
      "description": "Argo user ID of the counterparty."
    }
  },
  "additionalProperties": false
}

add_campaign_to_guild

Add a campaign to a guild. Any active member of the guild can do this; the calling user must be the campaign's GM (enforced server-side).

Argument	Type	Description
guildId*	string	Guild ID.
campaignId*	string	Campaign ID to add to the guild.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "guildId",
    "campaignId"
  ],
  "properties": {
    "guildId": {
      "type": "string",
      "minLength": 1,
      "description": "Guild ID."
    },
    "campaignId": {
      "type": "string",
      "minLength": 1,
      "description": "Campaign ID to add to the guild."
    }
  },
  "additionalProperties": false
}

add_co_gm

Send a user an assistant GM (co-GM) offer for a campaign. This does NOT add them immediately: the target must accept the offer before they become an assistant GM. Owner-only — the calling user must be the campaign's primary GM. Maximum 5 co-GMs per campaign.

Argument	Type	Description
userId*	string	Argo user ID of the user to promote to co-GM. Must be an existing user.
campaignId*	string	Campaign ID.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "userId"
  ],
  "properties": {
    "userId": {
      "type": "string",
      "minLength": 1,
      "description": "Argo user ID of the user to promote to co-GM. Must be an existing user."
    },
    "campaignId": {
      "type": "string",
      "minLength": 1,
      "description": "Campaign ID."
    }
  },
  "additionalProperties": false
}

add_guild_calendar_event

Add a new event to the guild's shared calendar. Owner/Admin only. startDateTime / endDateTime are ISO-8601 (e.g. 2026-06-12T19:00:00).

Argument	Type	Description
title*	string	Event title.
guildId*	string	Guild ID.
description	string	Optional event description.
endDateTime	string	Event end, ISO-8601 — optional.
startDateTime*	string	Event start, ISO-8601 (e.g. 2026-06-12T19:00:00).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "guildId",
    "title",
    "startDateTime"
  ],
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1,
      "description": "Event title."
    },
    "guildId": {
      "type": "string",
      "minLength": 1,
      "description": "Guild ID."
    },
    "description": {
      "type": "string",
      "description": "Optional event description."
    },
    "endDateTime": {
      "type": "string",
      "description": "Event end, ISO-8601 — optional."
    },
    "startDateTime": {
      "type": "string",
      "description": "Event start, ISO-8601 (e.g. 2026-06-12T19:00:00)."
    }
  },
  "additionalProperties": false
}

cancel_friend_request

Cancel a friend request you previously sent.

destructive

Argument	Type	Description
userId*	string	Argo user ID of the counterparty.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "userId"
  ],
  "properties": {
    "userId": {
      "type": "string",
      "minLength": 1,
      "description": "Argo user ID of the counterparty."
    }
  },
  "additionalProperties": false
}

create_archive_mnemons

Create Archive mnemons (archived lore that is no longer current). Players may not call this — GM/co-GM only.

Argument	Type	Description
items*	array
campaignId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title",
          "markdown"
        ],
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "description": "Title of the new entry."
          },
          "markdown": {
            "type": "string",
            "minLength": 1,
            "description": "Body content as Markdown. Mentions: @[label](mnemon:<entryId>). Images: ![caption](asset:<assetId>@<campaignId>) — upload the asset first."
          },
          "visibility": {
            "enum": [
              "HIDDEN",
              "INTERNAL",
              "PUBLIC"
            ],
            "type": "string"
          },
          "relatedEntryIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1
    },
    "campaignId": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

create_campaign

Create a new Argo campaign. The current user becomes GM and the calling token gains read+write access to the new campaign immediately (no re-consent needed). Requires the campaign.create OAuth scope, granted at consent time.

Argument	Type	Description
ruleSystem*	string	Rule system the campaign uses. E.g. 'Dungeons & Dragons 5e', 'Pathfinder 2e', 'Forbidden Lands'. Free-form; the WebAPI derives the slug from this.
description*	string	Short description of the campaign's setting, tone, and premise.
campaignName*	string	Display name of the campaign.
gameSystemSlug	string	Optional explicit slug for the public URL (e.g. 'dnd5e'). If omitted, the server derives one from ruleSystem.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignName",
    "description",
    "ruleSystem"
  ],
  "properties": {
    "ruleSystem": {
      "type": "string",
      "minLength": 1,
      "description": "Rule system the campaign uses. E.g. 'Dungeons & Dragons 5e', 'Pathfinder 2e', 'Forbidden Lands'. Free-form; the WebAPI derives the slug from this."
    },
    "description": {
      "type": "string",
      "minLength": 1,
      "description": "Short description of the campaign's setting, tone, and premise."
    },
    "campaignName": {
      "type": "string",
      "minLength": 1,
      "description": "Display name of the campaign."
    },
    "gameSystemSlug": {
      "type": "string",
      "description": "Optional explicit slug for the public URL (e.g. 'dnd5e'). If omitted, the server derives one from ruleSystem."
    }
  },
  "additionalProperties": false
}

create_custom_mnemons

Create custom-typed mnemons (any free-form entry that doesn't fit the other types). Players may not call this — GM/co-GM only.

Argument	Type	Description
items*	array
campaignId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title",
          "markdown"
        ],
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "description": "Title of the new entry."
          },
          "markdown": {
            "type": "string",
            "minLength": 1,
            "description": "Body content as Markdown. Mentions: @[label](mnemon:<entryId>). Images: ![caption](asset:<assetId>@<campaignId>) — upload the asset first."
          },
          "customType": {
            "type": "string",
            "description": "Optional descriptive subtype label."
          },
          "visibility": {
            "enum": [
              "HIDDEN",
              "INTERNAL",
              "PUBLIC"
            ],
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1
    },
    "campaignId": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

create_faction_mnemons

Create Faction mnemons (factions, guilds, cults, companies). Use memberNpcEntryIds to name each faction's NPC members; the server projects them into MEMBER relationships. Players may not call this — GM/co-GM only.

Argument	Type	Description
items*	array
campaignId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title",
          "markdown"
        ],
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "description": "Title of the new entry."
          },
          "markdown": {
            "type": "string",
            "minLength": 1,
            "description": "Body content as Markdown. Mentions: @[label](mnemon:<entryId>). Images: ![caption](asset:<assetId>@<campaignId>) — upload the asset first."
          },
          "visibility": {
            "enum": [
              "HIDDEN",
              "INTERNAL",
              "PUBLIC"
            ],
            "type": "string"
          },
          "relationshipIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "memberNpcEntryIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Members of this faction (NPC entryIds or titles)."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1
    },
    "campaignId": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

create_journal_mnemons

Create Journal mnemons (log of in-world events). Players may not call this — GM/co-GM only.

Argument	Type	Description
items*	array
campaignId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title",
          "markdown"
        ],
        "properties": {
          "date": {
            "type": "string"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "description": "Title of the new entry."
          },
          "outcome": {
            "type": "string"
          },
          "markdown": {
            "type": "string",
            "minLength": 1,
            "description": "Body content as Markdown. Mentions: @[label](mnemon:<entryId>). Images: ![caption](asset:<assetId>@<campaignId>) — upload the asset first."
          },
          "visibility": {
            "enum": [
              "HIDDEN",
              "INTERNAL",
              "PUBLIC"
            ],
            "type": "string"
          },
          "sessionNumber": {
            "type": "integer"
          },
          "consequenceEntryIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "involvedNpcEntryIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "involvedCharacterIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "involvedLocationEntryIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1
    },
    "campaignId": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

create_location_mnemons

Create Location mnemons (places — cities, dungeons, taverns). Use create_mnemon_relationship with PARENT_OF to nest larger places under one another after creation. Players may not call this — GM/co-GM only.

Argument	Type	Description
items*	array
campaignId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title",
          "markdown"
        ],
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "description": "Title of the new entry."
          },
          "levelId": {
            "type": "string",
            "description": "Unreal Engine level reference."
          },
          "markdown": {
            "type": "string",
            "minLength": 1,
            "description": "Body content as Markdown. Mentions: @[label](mnemon:<entryId>). Images: ![caption](asset:<assetId>@<campaignId>) — upload the asset first."
          },
          "visibility": {
            "enum": [
              "HIDDEN",
              "INTERNAL",
              "PUBLIC"
            ],
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1
    },
    "campaignId": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

create_lore_mnemons

Create Lore mnemons (world background, factions' beliefs, history). Players may not call this — GM/co-GM only.

Argument	Type	Description
items*	array
campaignId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title",
          "markdown"
        ],
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "description": "Title of the new entry."
          },
          "markdown": {
            "type": "string",
            "minLength": 1,
            "description": "Body content as Markdown. Mentions: @[label](mnemon:<entryId>). Images: ![caption](asset:<assetId>@<campaignId>) — upload the asset first."
          },
          "visibility": {
            "enum": [
              "HIDDEN",
              "INTERNAL",
              "PUBLIC"
            ],
            "type": "string"
          },
          "relatedEntryIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1
    },
    "campaignId": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

create_mnemon_relationship

Create a relationship between two mnemon entries. The label decides everything: its kind (containment or association) and how it reads (one_way or mutual) belong to the word itself — never send a per-edge override. All 16 labels: MEMBER (NPC ∈ Faction, mutual), ALLY (mutual), ENEMY (one-way), RIVAL (one-way), PARENT_OF (Location hierarchy — sourceEntryId is the outer/larger place, e.g. Region → City → District → Tavern), CONTAINS (Location → NPC present there), LOCATED_IN (NPC → Location; inverse of CONTAINS), HAS_SUBQUEST (Quest → subquest Quest), QUEST_GIVER (Quest → the NPC who gives it), QUEST_LOCATION (Quest → the Location where it is given or set), QUEST_RELATED_NPC (Quest → NPC), QUEST_RELATED_LOCATION (Quest → Location), SESSION_ATTENDEE_CHARACTER (SessionSummary → a character's Player), SESSION_ATTENDEE_NPC (SessionSummary → NPC), SESSION_FEATURED_QUEST (SessionSummary → Quest), SESSION_FEATURED_LOCATION (SessionSummary → Location). sourceEntryId is the 'from' side; targetEntryId is the 'to' side — which end is which matters. Call describe_mnemon_types for the full valid (sourceType, label, targetType) matrix. For faction membership prefer memberNpcEntryIds on the faction or affiliationEntryIds on the NPC; for a quest's giver, location and parent prefer giverId / locationId / parentQuestId on the quest, which keep each to one link. Session-summary links have no array equivalent — the SESSION_* labels are the only way to set them.

Argument	Type	Description
color	string
label*	string
direction	string	Deprecated: leave unset. The label alone decides the edge's shape — its kind and how it reads belong to the word (Mnemon D29/D33), and the server refuses a contradiction.
campaignId*

create_npc_mnemons

Create NPC mnemons (individual people). role is an optional free-text role or occupation. Use affiliationEntryIds to name the factions each NPC belongs to; the server projects them into MEMBER relationships. For a faction, guild or cult use create_faction_mnemons. Players may not call this — GM/co-GM only.

Argument	Type	Description
items*	array
campaignId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title",
          "markdown"
        ],
        "properties": {
          "role": {
            "type": "string",
            "description": "Free-text role or occupation, e.g. \"innkeeper\", \"captain of the guard\"."
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "description": "Title of the new entry."
          },
          "sheetId": {
            "type": "string"
          },
          "markdown": {
            "type": "string",
            "minLength": 1,
            "description": "Body content as Markdown. Mentions: @[label](mnemon:<entryId>). Images: ![caption](asset:<assetId>@<campaignId>) — upload the asset first."
          },
          "visibility": {
            "enum": [
              "HIDDEN",
              "INTERNAL",
              "PUBLIC"
            ],
            "type": "string"
          },
          "relationshipIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "affiliationEntryIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Factions this person belongs to (Faction entryIds or titles)."
          },
          "primaryLocationEntryId": {
            "type": "string",
            "description": "Home location — entryId or exact title."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1
    },
    "campaignId": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

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.

Argument	Type	Description
items*	array
campaignId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title"
        ],
        "properties": {
          "hook": {
            "type": "string",
            "description": "The one line players see under the title in the quest log. An empty string clears it."
          },
          "kind": {
            "enum": [
              "Main",
              "Side",
              "Personal"
            ],
            "type": "string",
            "description": "Main | Side | Personal. Reads as Side when unset."
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "steps": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "title"
              ],
              "properties": {
                "notes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Free-text bullet notes for the step."
                },
                "title": {
                  "type": "string",
                  "description": "Short label for the step, e.g. 'Talk to the innkeeper'."
                },
                "status": {
                  "enum": [
                    "Hidden",
                    "Available",
                    "Active",
                    "Completed",
                    "Failed",
                    "TurnedIn",
                    "Abandoned",
                    "Expired",
                    "OnHold"
                  ],
                  "type": "string",
                  "description": "Defaults to 'Available' when omitted. Unknown values are coerced server-side."
                },
                "stepId": {
                  "type": "string",
                  "description": "Optional. Server generates a fresh UUID when blank. Provide an existing stepId to reuse linkedStepIds."
                },
                "description": {
                  "type": "string"
                },
                "targetNpcEntryIds": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "NPCs involved in this step (entryIds or titles)."
                },
                "targetLocationEntryIds": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Locations involved in this step."
                }
              },
              "additionalProperties": false
            },
            "description": "Retired: the old quest board's steps, for quests the migration has not converted. Send objectives."
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "description": "Title of the new entry."
          },
          "status": {
            "enum": [
              "Available",
              "Active",
              "Completed",
              "Failed"
            ],
            "type": "string",
            "description": "Available | Active | Completed | Failed. Reads as Available when unset."
          },
          "giverId": {
            "type": "string",
            "description": "Who gives the quest: an NPC's entryId or exact title (its Quest giver link). On update an empty string removes it."
          },
          "gmNotes": {
            "type": "string",
            "description": "GM-only notes, in Markdown. Players never see them."
          },
          "rewards": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "The chip to rewrite, as get_mnemon's quest.rewards[].id names it. Omit for a new chip."
                },
                "kind": {
                  "enum": [
                    "currency",
                    "xp",
                    "item",
                    "other"
                  ],
                  "type": "string",
                  "description": "currency | xp | item | other. Makes this a reward chip — send it on every reward."
                },
                "unit": {
                  "type": "string",
                  "description": "currency chips: the coin, as the campaign's setting names it (e.g. coin.gp), or free text such as 'gold'."
                },
                "label": {
                  "type": "string",
                  "description": "What the chip says: an item's name, a favour, a title."
                },
                "notes": {
                  "type": "string",
                  "description": "Retired reward row: notes."
                },
                "amount": {
                  "type": "number",
                  "description": "How many: coins, experience points, a stack."
                },
                "hidden": {
                  "type": "boolean",
                  "description": "true hides the chip from players, false shows it; omitted keeps what it has (a new one is shown)."
                },
                "itemId": {
                  "type": "string",
                  "description": "Retired reward row: a free-text item reference."
                },
                "entryId": {
                  "type": "string",
                  "description": "item chips: the mnemon entry it links to (entryId or exact title). Not with ruleEntryId."
                },
                "unitLabel": {
                  "type": "string",
                  "description": "How the coin reads, e.g. 'Gold piece'."
                },
                "rewardType": {
                  "type": "string",
                  "description": "Retired reward row, without kind: Gold | Item | XP | Reputation …"
                },
                "ruleEntryId": {
                  "type": "string",
                  "description": "item chips: the rules-library entry it links to. Not with entryId."
                },
                "linkedStepIds": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Retired reward row: the stepIds or subquest entry ids that unlock it."
                }
              },
              "additionalProperties": false
            },
            "description": "The reward chips, each with its kind."
          },
          "markdown": {
            "type": "string",
            "minLength": 1,
            "description": "The quest's prose in Markdown: its Background when background is not given. Mentions: @[label](mnemon:<entryId>)."
          },
          "expiresAt": {
            "type": "string",
            "description": "Retired quest board field (ISO-8601)."
          },
          "background": {
            "type": "string",
            "description": "The Background section, in Markdown."
          },
          "issuerText": {
            "type": "string",
            "description": "Retired quest board field: write it into background."
          },
          "locationId": {
            "type": "string",
            "description": "Where the quest is given or set: a Location's entryId or exact title. On update an empty string removes it."
          },
          "objectives": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "text"
              ],
              "properties": {
                "id": {
                  "type": "string",
                  "description": "The objective to rewrite, as get_mnemon's quest.objectives[].id names it. Omit for a new objective."
                },
                "text": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The objective, one line of Markdown. Mentions: @[label](mnemon:<entryId>)."
                },
                "state": {
                  "enum": [
                    "open",
                    "done",
                    "failed"
                  ],
                  "type": "string",
                  "description": "open (the default), done or failed."
                },
                "hidden": {
                  "type": "boolean",
                  "description": "true hides it from players, false shows it; omitted keeps what it has (a new one is shown)."
                },
                "children": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "required": [
                      "text"
                    ],
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "The objective to rewrite, as get_mnemon's quest.objectives[].id names it. Omit for a new objective."
                      },
                      "text": {
                        "type": "string",
                        "minLength": 1,
                        "description": "The objective, one line of Markdown. Mentions: @[label](mnemon:<entryId>)."
                      },
                      "state": {
                        "enum": [
                          "open",
                          "done",
                          "failed"
                        ],
                        "type": "string",
                        "description": "open (the default), done or failed."
                      },
                      "hidden": {
                        "type": "boolean",
                        "description": "true hides it from players, false shows it; omitted keeps what it has (a new one is shown)."
                      },
                      "optional": {
                        "type": "boolean",
                        "description": "An optional objective does not count toward the quest's progress. Defaults to false."
                      }
                    },
                    "additionalProperties": false
                  },
                  "description": "Its sub-objectives, in order. Omitted keeps the ones it has; an empty list removes them."
                },
                "optional": {
                  "type": "boolean",
                  "description": "An optional objective does not count toward the quest's progress. Defaults to false."
                }
              },
              "additionalProperties": false
            },
            "description": "The objectives, in order."
          },
          "repeatable": {
            "type": "boolean",
            "description": "Retired quest board field."
          },
          "visibility": {
            "enum": [
              "HIDDEN",
              "INTERNAL",
              "PUBLIC"
            ],
            "type": "string"
          },
          "questStatus": {
            "type": "string",
            "description": "Retired: send status."
          },
          "parentQuestId": {
            "type": "string",
            "description": "The quest this one belongs to: a Quest's entryId or exact title. On update an empty string removes it."
          },
          "playersCanTick": {
            "type": "boolean",
            "description": "Whether players may tick the objectives they can see. Off by default."
          },
          "issuerNpcEntryId": {
            "type": "string",
            "description": "Retired quest board field: send giverId."
          },
          "subQuestEntryIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "This quest's subquests (entryIds or titles). Prefer parentQuestId on each subquest."
          },
          "relatedNpcEntryIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "NPCs the quest involves (entryIds or titles)."
          },
          "relatedLocationEntryIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Locations the quest involves (entryIds or titles)."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1
    },
    "campaignId": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

create_session

Schedule a campaign session. Provide an ISO-8601 startAt; endAt is optional. Useful for laying out planned arcs or recurring play nights.

Argument	Type	Description
endAt	string	Session end time as an ISO-8601 instant.
title*	string	Session title (e.g. 'Session 12: The Dragon's Lair').
startAt*	string	Session start time as an ISO-8601 instant (e.g. '2026-06-01T19:00:00Z').
campaignId*	string	Campaign ID.
description	string	Optional session description / GM notes.
invitedUserIds	array	User IDs to invite (must be active campaign members).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "title",
    "startAt"
  ],
  "properties": {
    "endAt": {
      "type": "string",
      "description": "Session end time as an ISO-8601 instant."
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "description": "Session title (e.g. 'Session 12: The Dragon's Lair')."
    },
    "startAt": {
      "type": "string",
      "minLength": 1,
      "description": "Session start time as an ISO-8601 instant (e.g. '2026-06-01T19:00:00Z')."
    },
    "campaignId": {
      "type": "string",
      "minLength": 1,
      "description": "Campaign ID."
    },
    "description": {
      "type": "string",
      "description": "Optional session description / GM notes."
    },
    "invitedUserIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "User IDs to invite (must be active campaign members)."
    }
  },
  "additionalProperties": false
}

create_session_summary_mnemons

Create SessionSummary mnemons (the memory of one played session): the story as the Markdown body, plus a short recap shown as "Previously on". Players may not call this — GM/co-GM only.

Argument	Type	Description
items*	array
campaignId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title",
          "markdown"
        ],
        "properties": {
          "date": {
            "type": "string",
            "description": "When the session was played: ISO date (2024-02-10) or date-time. Set it for a past chapter brought into Argo. Leave it out for a summary linked to a calendar session: it then takes the session's date. Linking never clears it. An empty string clears it."
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "recap": {
            "type": "string",
            "description": "Short recap, 1-3 sentences, ending on where the party stands. Shown as \"Previously on\" on the next session and the campaign Dashboard. The full story goes in the Markdown body."
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "description": "Title of the new entry."
          },
          "markdown": {
            "type": "string",
            "minLength": 1,
            "description": "The session's story as Markdown, with headed sections such as What happened, Decisions, Loot, Open threads, Combats and Where we left off. Mentions: @[label](mnemon:<entryId>)."
          },
          "visibility": {
            "enum": [
              "HIDDEN",
              "INTERNAL",
              "PUBLIC"
            ],
            "type": "string"
          },
          "sessionNumber": {
            "type": "integer",
            "description": "The session's number in the party's history, a positive whole number, kept as written. Leave it out to let Argo number the summary by its place in the history (after the highest number before it). Linking never clears it. 0 clears it."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1
    },
    "campaignId": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

delete_mnemon

Permanently delete a mnemon entry and every relationship that touches it. GM-only on the backend. This cannot be undone — confirm with the user before calling. entryId accepts a hex id or an exact title.

destructive

Argument	Type	Description
entryId*	string	Mnemon entry ID (hex) or exact title.
campaignId*	string	Campaign ID.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "entryId"
  ],
  "properties": {
    "entryId": {
      "type": "string",
      "minLength": 1,
      "description": "Mnemon entry ID (hex) or exact title."
    },
    "campaignId": {
      "type": "string",
      "minLength": 1,
      "description": "Campaign ID."
    }
  },
  "additionalProperties": false
}

delete_mnemon_relationship

Delete a relationship by id.

destructive

Argument	Type	Description
campaignId*	string
relationshipId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "relationshipId"
  ],
  "properties": {
    "campaignId": {
      "type": "string",
      "minLength": 1
    },
    "relationshipId": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

describe_mnemon_types

Returns a catalog of all mnemon types, their type-specific fields, and the full valid relationship matrix (sourceType → label → targetType). Call this before create_mnemon or create_mnemon_relationship when you are unsure which type or label to use. A person is an NPC and a faction is a Faction; Player and PlayerParty are made only by the server and cannot be created.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

forum_create_topic

Create a new forum topic (bug report, feature request, or general discussion). Always call forum_search first to check for duplicates. Call forum_list_categories to get the correct categoryId.

Argument	Type	Description
raw*	string	Topic body in Markdown.
title*	string	Topic title. Keep it concise and descriptive.
categoryId*	integer	Numeric category ID. Call forum_list_categories first if unsure.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "title",
    "raw",
    "categoryId"
  ],
  "properties": {
    "raw": {
      "type": "string",
      "minLength": 1,
      "description": "Topic body in Markdown."
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "description": "Topic title. Keep it concise and descriptive."
    },
    "categoryId": {
      "type": "integer",
      "description": "Numeric category ID. Call forum_list_categories first if unsure."
    }
  },
  "additionalProperties": false
}

forum_get_latest_topics

Get the latest active topics across all forum categories.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

forum_get_notifications

Get the current user's forum notifications (replies, mentions, likes).

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

forum_get_user_posts

List topics created by the current user on the forum.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

forum_list_categories

List all Discourse forum categories at community.argo.games. Call this first when the user wants to post a bug report or feature request — you need the categoryId to create a topic.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

forum_list_topics

List topics in a specific forum category. Provide categorySlug and/or categoryId — given only one, the other is resolved from the category list automatically. Use forum_list_categories to discover categories.

read-only

Argument	Type	Description
categoryId	integer	Numeric category ID. Provide this and/or categorySlug.
categorySlug	string	Category slug (e.g. 'bug-reports'). Provide this and/or categoryId.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "categoryId": {
      "type": "integer",
      "description": "Numeric category ID. Provide this and/or categorySlug."
    },
    "categorySlug": {
      "type": "string",
      "minLength": 1,
      "description": "Category slug (e.g. 'bug-reports'). Provide this and/or categoryId."
    }
  },
  "additionalProperties": false
}

forum_read_topic

Read the full content of a forum topic including all posts and replies. Post bodies are returned as plain text (HTML markup is stripped).

read-only

Argument	Type	Description
topicId*	integer	Numeric Discourse topic ID.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "topicId"
  ],
  "properties": {
    "topicId": {
      "type": "integer",
      "description": "Numeric Discourse topic ID."
    }
  },
  "additionalProperties": false
}

forum_reply

Reply to an existing forum topic.

Argument	Type	Description
raw*	string	Reply body in Markdown.
topicId*	integer	Numeric Discourse topic ID to reply to.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "topicId",
    "raw"
  ],
  "properties": {
    "raw": {
      "type": "string",
      "minLength": 1,
      "description": "Reply body in Markdown."
    },
    "topicId": {
      "type": "integer",
      "description": "Numeric Discourse topic ID to reply to."
    }
  },
  "additionalProperties": false
}

forum_search

Search forum topics and posts. Supports Discourse search syntax: #category-slug to filter by category, @username to filter by author. Always search before creating a bug report or feature request to avoid duplicates.

read-only

Argument	Type	Description
q*	string	Search query. Supports Discourse search syntax (e.g. #category, @username).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "description": "Search query. Supports Discourse search syntax (e.g. #category, @username)."
    }
  },
  "additionalProperties": false
}

get_campaign

Retrieve details of an Argo campaign (name, description, rule system, co-GMs).

read-only

Argument	Type	Description
campaignId*	string	The ID of the campaign to retrieve.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId"
  ],
  "properties": {
    "campaignId": {
      "type": "string",
      "minLength": 1,
      "description": "The ID of the campaign to retrieve."
    }
  },
  "additionalProperties": false
}

get_guild

Retrieve full details of a guild (members, campaigns, calendar metadata).

read-only

Argument	Type	Description
guildId*	string	Guild ID to retrieve.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "guildId"
  ],
  "properties": {
    "guildId": {
      "type": "string",
      "minLength": 1,
      "description": "Guild ID to retrieve."
    }
  },
  "additionalProperties": false
}

get_mnemon

Get the full details of a specific mnemon entry (title, blocks, type properties). For a quest, `quest` holds its status, kind, playersCanTick, objectives and reward chips (with their ids), progress and reward totals, as the current user may see them — read objectives and rewards there, not from blocks.

read-only

Argument	Type	Description
entryId*	string	Mnemon entry ID (hex) or exact title.
campaignId*	string	Campaign ID.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "entryId"
  ],
  "properties": {
    "entryId": {
      "type": "string",
      "minLength": 1,
      "description": "Mnemon entry ID (hex) or exact title."
    },
    "campaignId": {
      "type": "string",
      "minLength": 1,
      "description": "Campaign ID."
    }
  },
  "additionalProperties": false
}

get_session

Get details of a single campaign session.

read-only

Argument	Type	Description
sessionId*	string	Session ID.
campaignId*	string	Campaign ID.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "sessionId"
  ],
  "properties": {
    "sessionId": {
      "type": "string",
      "minLength": 1,
      "description": "Session ID."
    },
    "campaignId": {
      "type": "string",
      "minLength": 1,
      "description": "Campaign ID."
    }
  },
  "additionalProperties": false
}

invite_guild_member

Invite a user to join the guild. Owner/Admin only.

Argument	Type	Description
userId*	string	Argo user ID to invite.
guildId*	string	Guild ID.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "guildId",
    "userId"
  ],
  "properties": {
    "userId": {
      "type": "string",
      "minLength": 1,
      "description": "Argo user ID to invite."
    },
    "guildId": {
      "type": "string",
      "minLength": 1,
      "description": "Guild ID."
    }
  },
  "additionalProperties": false
}

list_campaigns

List all Argo campaigns the current grant token has access to, including the access level ("read" or "read+write") for each. Call this first when the user has not provided a campaign ID. Each entry includes both `campaignName` and `id` (shown inline as `[id: …]` and also in structuredContent.idMap). Use the `id` verbatim for any subsequent tool call that takes a `campaignId`. In prose to the user, refer to campaigns by `campaignName`; do not print the raw `id` unless asked.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

list_co_gms

List the assistant GMs (co-GMs) of a campaign.

read-only

Argument	Type	Description
campaignId*	string	Campaign ID.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId"
  ],
  "properties": {
    "campaignId": {
      "type": "string",
      "minLength": 1,
      "description": "Campaign ID."
    }
  },
  "additionalProperties": false
}

list_friends

List the current user's accepted friends.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

list_guild_members

List the members of a guild (id, role, status, invitedAt, joinedAt).

read-only

Argument	Type	Description
guildId*	string	Guild ID.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "guildId"
  ],
  "properties": {
    "guildId": {
      "type": "string",
      "minLength": 1,
      "description": "Guild ID."
    }
  },
  "additionalProperties": false
}

list_guilds

List the guilds the current user belongs to, with role (Owner/Admin/Member), member count, and campaign count. Requires the guild.read scope. Each entry includes both `name` and `guildId` (shown inline as `[id: …]` and in structuredContent.idMap). Use the `guildId` verbatim for any tool that takes one; refer to guilds by `name` in prose to the user.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

list_mnemon_relationships

List the relationships of a mnemon entry, split into outgoing edges, incoming edges, and a flat list of linked entries (entryId/title/type/relationshipTypes). Use this to find members of a faction, allies/enemies of an NPC, etc.

read-only

Argument	Type	Description
entryId*	string
campaignId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "entryId"
  ],
  "properties": {
    "entryId": {
      "type": "string",
      "minLength": 1
    },
    "campaignId": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

list_mnemons

List mnemon (lore/memory) entries for an Argo campaign. Optional filters: `title` (case-insensitive substring on entry title only) and `type` (e.g. NPC, Location, Quest). To find entries by what they CONTAIN, use search_mnemons instead. Returns up to `limit` entries (default 100); when `hasMore` is true, call again with `offset` = the returned `nextOffset` to fetch the next page. Each entry includes both `title` and `entryId` (shown inline as `[id: …]` and in structuredContent.idMap). Use the `entryId` verbatim for any tool that takes one; refer to entries by `title` in prose to the user.

read-only

Argument	Type	Description
type	string	Mnemon type filter (NPC, Location, Quest, …).
limit	integer	Maximum entries to return (default 100).
title	string	Case-insensitive substring filter on title.
offset	integer	Entries to skip. Pass the nextOffset from the previous call to fetch the next page.
campaignId*	string	ID of the campaign.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId"
  ],
  "properties": {
    "type": {
      "type": "string",
      "description": "Mnemon type filter (NPC, Location, Quest, …)."
    },
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Maximum entries to return (default 100)."
    },
    "title": {
      "type": "string",
      "description": "Case-insensitive substring filter on title."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Entries to skip. Pass the nextOffset from the previous call to fetch the next page."
    },
    "campaignId": {
      "type": "string",
      "minLength": 1,
      "description": "ID of the campaign."
    }
  },
  "additionalProperties": false
}

list_received_friend_requests

List incoming friend requests awaiting your response.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

list_sent_friend_requests

List outgoing friend requests that are still pending.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

list_sessions

List campaign sessions for a given month (defaults to the current month).

read-only

Argument	Type	Description
year	integer	Calendar year. Defaults to current year.
month	integer	Calendar month (1-12). Defaults to current month.
campaignId*	string	Campaign ID.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "description": "Calendar year. Defaults to current year."
    },
    "month": {
      "type": "integer",
      "maximum": 12,
      "minimum": 1,
      "description": "Calendar month (1-12). Defaults to current month."
    },
    "campaignId": {
      "type": "string",
      "minLength": 1,
      "description": "Campaign ID."
    }
  },
  "additionalProperties": false
}

reject_friend_request

Reject an incoming friend request from the given user.

destructive

Argument	Type	Description
userId*	string	Argo user ID of the counterparty.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "userId"
  ],
  "properties": {
    "userId": {
      "type": "string",
      "minLength": 1,
      "description": "Argo user ID of the counterparty."
    }
  },
  "additionalProperties": false
}

remove_co_gm

Remove a co-GM from a campaign. Owner-only or self-removal.

destructive

Argument	Type	Description
userId*	string	User ID of the co-GM to remove.
campaignId*	string	Campaign ID.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "userId"
  ],
  "properties": {
    "userId": {
      "type": "string",
      "minLength": 1,
      "description": "User ID of the co-GM to remove."
    },
    "campaignId": {
      "type": "string",
      "minLength": 1,
      "description": "Campaign ID."
    }
  },
  "additionalProperties": false
}

remove_guild_member

Remove a member from the guild. Owner/Admin only.

destructive

Argument	Type	Description
userId*	string	User ID of the member to remove.
guildId*	string	Guild ID.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "guildId",
    "userId"
  ],
  "properties": {
    "userId": {
      "type": "string",
      "minLength": 1,
      "description": "User ID of the member to remove."
    },
    "guildId": {
      "type": "string",
      "minLength": 1,
      "description": "Guild ID."
    }
  },
  "additionalProperties": false
}

search_mnemons

Full-text search across mnemon titles, tags, and body content (case-insensitive substring). Prefer this over list_mnemons when looking for entries by what they contain — e.g. "what do we know about the Red Oracle?". Each hit reports which fields matched (title/tags/content) and up to 3 body snippets; a snippet's blockId is the same block id get_mnemon returns, so you can target the matched block directly in update_mnemons_content. Only content visible to the current user is searched. Returns at most `limit` hits (default 20, max 50) plus `hasMore`.

read-only

Argument	Type	Description
type	string	Mnemon type filter (NPC, Location, Quest, …).
limit	integer	Maximum results (default 20).
query*	string	Text to find (case-insensitive substring) in mnemon titles, tags, and body content.
campaignId*	string	ID of the campaign.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "query"
  ],
  "properties": {
    "type": {
      "type": "string",
      "description": "Mnemon type filter (NPC, Location, Quest, …)."
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum results (default 20)."
    },
    "query": {
      "type": "string",
      "minLength": 2,
      "description": "Text to find (case-insensitive substring) in mnemon titles, tags, and body content."
    },
    "campaignId": {
      "type": "string",
      "minLength": 1,
      "description": "ID of the campaign."
    }
  },
  "additionalProperties": false
}

send_friend_request

Send a friend request to another Argo user.

Argument	Type	Description
userId*	string	Argo user ID of the counterparty.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "userId"
  ],
  "properties": {
    "userId": {
      "type": "string",
      "minLength": 1,
      "description": "Argo user ID of the counterparty."
    }
  },
  "additionalProperties": false
}

set_guild_member_role

Change a guild member's role to Owner, Admin, or Member. Owner/Admin only. Note that promoting another user to Owner transfers the guild — confirm with the user first.

Argument	Type	Description
role*	string	New role.
userId*	string	Member to change.
guildId*	string	Guild ID.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "guildId",
    "userId",
    "role"
  ],
  "properties": {
    "role": {
      "enum": [
        "Owner",
        "Admin",
        "Member"
      ],
      "type": "string",
      "description": "New role."
    },
    "userId": {
      "type": "string",
      "minLength": 1,
      "description": "Member to change."
    },
    "guildId": {
      "type": "string",
      "minLength": 1,
      "description": "Guild ID."
    }
  },
  "additionalProperties": false
}

set_quest_objective_state

Tick, fail or reopen one objective of a quest by its id (get_mnemon's quest.objectives[].id), at any depth, without rewriting the quest. A GM sets any state. A player may only tick an objective they can see done, or undo that, and only while the quest's playersCanTick is on. Returns the quest as get_mnemon shows it, its progress recounted.

Argument	Type	Description
state*	string	open, done or failed.
entryId*	string	The quest: entryId (hex) or exact title.
campaignId*	string	Campaign ID.
objectiveId*	string	The objective, as get_mnemon's quest.objectives[].id names it.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "entryId",
    "objectiveId",
    "state"
  ],
  "properties": {
    "state": {
      "enum": [
        "open",
        "done",
        "failed"
      ],
      "type": "string",
      "description": "open, done or failed."
    },
    "entryId": {
      "type": "string",
      "minLength": 1,
      "description": "The quest: entryId (hex) or exact title."
    },
    "campaignId": {
      "type": "string",
      "minLength": 1,
      "description": "Campaign ID."
    },
    "objectiveId": {
      "type": "string",
      "minLength": 1,
      "description": "The objective, as get_mnemon's quest.objectives[].id names it."
    }
  },
  "additionalProperties": false
}

update_archive_mnemons

Update typed/meta fields of Archive mnemons.

Argument	Type	Description
items*	array
campaignId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "entryId"
        ],
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string"
          },
          "entryId": {
            "type": "string",
            "minLength": 1,
            "description": "Mnemon entry id (hex) or exact title."
          },
          "visibility": {
            "enum": [
              "HIDDEN",
              "INTERNAL",
              "PUBLIC"
            ],
            "type": "string"
          },
          "relatedEntryIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1
    },
    "campaignId": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

update_campaign

Update a campaign's display name and/or description. Both fields optional — only supplied fields are changed; pass an empty string to clear the description. GMs and co-GMs can call this; rule-system swaps remain WebApp-only.

Argument	Type	Description
campaignId*	string	ID of the campaign to update.
campaignName	string	New display name. Omit to leave unchanged.
campaignDescription	string	New description (setting, tone, premise). Omit to leave unchanged. Pass an empty string to clear the existing description.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId"
  ],
  "properties": {
    "campaignId": {
      "type": "string",
      "minLength": 1,
      "description": "ID of the campaign to update."
    },
    "campaignName": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "New display name. Omit to leave unchanged."
    },
    "campaignDescription": {
      "type": "string",
      "maxLength": 5000,
      "description": "New description (setting, tone, premise). Omit to leave unchanged. Pass an empty string to clear the existing description."
    }
  },
  "additionalProperties": false
}

update_custom_mnemons

Update typed/meta fields of Custom-typed mnemons.

Argument	Type	Description
items*	array
campaignId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "entryId"
        ],
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string"
          },
          "entryId": {
            "type": "string",
            "minLength": 1,
            "description": "Mnemon entry id (hex) or exact title."
          },
          "customType": {
            "type": "string"
          },
          "visibility": {
            "enum": [
              "HIDDEN",
              "INTERNAL",
              "PUBLIC"
            ],
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1
    },
    "campaignId": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

update_faction_mnemons

Update typed/meta fields of Faction mnemons (visibility, tags, members). An entry that is not a Faction fails its item. Does NOT modify content blocks — use update_mnemons_content for that.

Argument	Type	Description
items*	array
campaignId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "entryId"
        ],
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string"
          },
          "entryId": {
            "type": "string",
            "minLength": 1,
            "description": "Mnemon entry id (hex) or exact title."
          },
          "visibility": {
            "enum": [
              "HIDDEN",
              "INTERNAL",
              "PUBLIC"
            ],
            "type": "string"
          },
          "relationshipIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "memberNpcEntryIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Members of this faction (NPC entryIds or titles)."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1
    },
    "campaignId": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

update_journal_mnemons

Update typed/meta fields of Journal mnemons.

Argument	Type	Description
items*	array
campaignId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "entryId"
        ],
        "properties": {
          "date": {
            "type": "string"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string"
          },
          "entryId": {
            "type": "string",
            "minLength": 1,
            "description": "Mnemon entry id (hex) or exact title."
          },
          "outcome": {
            "type": "string"
          },
          "visibility": {
            "enum": [
              "HIDDEN",
              "INTERNAL",
              "PUBLIC"
            ],
            "type": "string"
          },
          "sessionNumber": {
            "type": "integer"
          },
          "consequenceEntryIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "involvedNpcEntryIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "involvedCharacterIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "involvedLocationEntryIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1
    },
    "campaignId": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

update_location_mnemons

Update typed/meta fields of Location mnemons.

Argument	Type	Description
items*	array
campaignId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "entryId"
        ],
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string"
          },
          "entryId": {
            "type": "string",
            "minLength": 1,
            "description": "Mnemon entry id (hex) or exact title."
          },
          "levelId": {
            "type": "string"
          },
          "visibility": {
            "enum": [
              "HIDDEN",
              "INTERNAL",
              "PUBLIC"
            ],
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1
    },
    "campaignId": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

update_lore_mnemons

Update typed/meta fields of Lore mnemons.

Argument	Type	Description
items*	array
campaignId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "entryId"
        ],
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string"
          },
          "entryId": {
            "type": "string",
            "minLength": 1,
            "description": "Mnemon entry id (hex) or exact title."
          },
          "visibility": {
            "enum": [
              "HIDDEN",
              "INTERNAL",
              "PUBLIC"
            ],
            "type": "string"
          },
          "relatedEntryIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1
    },
    "campaignId": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

update_mnemons_content

Edit the body content of one or more mnemon entries. Each item carries an entryId and an ordered list of ops (append, insertAfter, replace, remove) applied atomically per entry. Op content is authored as Markdown (headings, lists, quotes, code fences, bold/italic, links) — do NOT send HTML. Mentions: @[label](mnemon:<entryId>). Images: ![caption](asset:<assetId>@<campaignId>) — upload the asset first; inline base64 / data: URLs are not accepted. Node addressing: get body-node ids from get_mnemon, then target them in replace/remove/insertAfter. A single op's Markdown may produce several nodes; new nodes get fresh server-generated ids (replace keeps the original id on the first new node). On a bad op (missing blockId, unknown op, etc.) the whole entry's batch is rejected with the failedOpIndex; no partial mutation per entry. See describe_mnemon_types.blockOps for the full vocabulary.

Argument	Type	Description
items*	array
campaignId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "entryId",
          "ops"
        ],
        "properties": {
          "ops": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "op"
              ],
              "properties": {
                "op": {
                  "enum": [
                    "append",
                    "insertAfter",
                    "replace",
                    "remove"
                  ],
                  "type": "string",
                  "description": "The op to apply."
                },
                "blockId": {
                  "type": "string",
                  "description": "Required for replace and remove: a body node id from get_mnemon."
                },
                "markdown": {
                  "type": "string",
                  "description": "Markdown content for append / insertAfter / replace. May produce several body nodes. Mentions: @[label](mnemon:<entryId>); images: ![caption](asset:<assetId>@<campaignId>)."
                },
                "afterBlockId": {
                  "type": "string",
                  "description": "Required for insertAfter: the body node id the new content follows."
                }
              },
              "description": "A single body mutation, keyed by node id. See describe_mnemon_types.blockOps.",
              "additionalProperties": false
            },
            "maxItems": 50,
            "minItems": 1,
            "description": "Ordered ops to apply atomically per entry."
          },
          "entryId": {
            "type": "string",
            "minLength": 1,
            "description": "Mnemon entry id (hex) or exact title."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1
    },
    "campaignId": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

update_npc_mnemons

Update typed/meta fields of NPC mnemons (visibility, tags, role, faction membership, etc.). An entry that is not an NPC fails its item; use update_faction_mnemons for a faction. Does NOT modify content blocks — use update_mnemons_content for that. Set visibility=PUBLIC on multiple NPCs in a single call by listing them in items[].

Argument	Type	Description
items*	array
campaignId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "entryId"
        ],
        "properties": {
          "role": {
            "type": "string",
            "description": "Free-text role or occupation. An empty string clears it."
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string"
          },
          "entryId": {
            "type": "string",
            "minLength": 1,
            "description": "Mnemon entry id (hex) or exact title."
          },
          "sheetId": {
            "type": "string"
          },
          "visibility": {
            "enum": [
              "HIDDEN",
              "INTERNAL",
              "PUBLIC"
            ],
            "type": "string"
          },
          "relationshipIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "affiliationEntryIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Factions this person belongs to (Faction entryIds or titles)."
          },
          "primaryLocationEntryId": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1
    },
    "campaignId": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

update_party_mnemons

Update typed/meta fields of PlayerParty mnemons — one per party in the campaign. PlayerParty mnemons cannot be created: the server makes one for each party. Who may edit an entry is decided by its own permissions.

Argument	Type	Description
items*	array
campaignId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "entryId"
        ],
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string"
          },
          "entryId": {
            "type": "string",
            "minLength": 1,
            "description": "Mnemon entry id (hex) or exact title."
          },
          "visibility": {
            "enum": [
              "HIDDEN",
              "INTERNAL",
              "PUBLIC"
            ],
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1
    },
    "campaignId": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

update_player_mnemons

Update typed/meta fields of Player mnemons — one per character in a party. Player mnemons cannot be created: the server makes one for each character that joins a party. Who may edit an entry is decided by its own permissions.

Argument	Type	Description
items*	array
campaignId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "entryId"
        ],
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string"
          },
          "entryId": {
            "type": "string",
            "minLength": 1,
            "description": "Mnemon entry id (hex) or exact title."
          },
          "partyId": {
            "type": "string"
          },
          "visibility": {
            "enum": [
              "HIDDEN",
              "INTERNAL",
              "PUBLIC"
            ],
            "type": "string"
          },
          "characterId": {
            "type": "string"
          },
          "parentEntryId": {
            "type": "string",
            "description": "The character's party: a PlayerParty entryId or exact title."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1
    },
    "campaignId": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

update_quest_mnemons

Update Quest mnemons. A field left out is left as it is: status, kind, playersCanTick, hook, the giverId / locationId / parentQuestId links (an empty string removes one), and objectives, rewards, background or gmNotes, each of which replaces its part of the quest and keeps the rest. Name existing objectives and chips by the ids get_mnemon's `quest` returns so they keep what the GM wrote under them. To tick one objective, use set_quest_objective_state.

Argument	Type	Description
items*	array
campaignId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "entryId"
        ],
        "properties": {
          "hook": {
            "type": "string",
            "description": "The one line players see under the title in the quest log. An empty string clears it."
          },
          "kind": {
            "enum": [
              "Main",
              "Side",
              "Personal"
            ],
            "type": "string",
            "description": "Main | Side | Personal. Reads as Side when unset."
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "steps": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "title"
              ],
              "properties": {
                "notes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Free-text bullet notes for the step."
                },
                "title": {
                  "type": "string",
                  "description": "Short label for the step, e.g. 'Talk to the innkeeper'."
                },
                "status": {
                  "enum": [
                    "Hidden",
                    "Available",
                    "Active",
                    "Completed",
                    "Failed",
                    "TurnedIn",
                    "Abandoned",
                    "Expired",
                    "OnHold"
                  ],
                  "type": "string",
                  "description": "Defaults to 'Available' when omitted. Unknown values are coerced server-side."
                },
                "stepId": {
                  "type": "string",
                  "description": "Optional. Server generates a fresh UUID when blank. Provide an existing stepId to reuse linkedStepIds."
                },
                "description": {
                  "type": "string"
                },
                "targetNpcEntryIds": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "NPCs involved in this step (entryIds or titles)."
                },
                "targetLocationEntryIds": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Locations involved in this step."
                }
              },
              "additionalProperties": false
            },
            "description": "Retired: the old quest board's steps, for quests the migration has not converted. Send objectives."
          },
          "title": {
            "type": "string"
          },
          "status": {
            "enum": [
              "Available",
              "Active",
              "Completed",
              "Failed"
            ],
            "type": "string",
            "description": "Available | Active | Completed | Failed. Reads as Available when unset."
          },
          "entryId": {
            "type": "string",
            "minLength": 1,
            "description": "Mnemon entry id (hex) or exact title."
          },
          "giverId": {
            "type": "string",
            "description": "Who gives the quest: an NPC's entryId or exact title (its Quest giver link). On update an empty string removes it."
          },
          "gmNotes": {
            "type": "string",
            "description": "Replaces the GM-only notes, in Markdown."
          },
          "rewards": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "The chip to rewrite, as get_mnemon's quest.rewards[].id names it. Omit for a new chip."
                },
                "kind": {
                  "enum": [
                    "currency",
                    "xp",
                    "item",
                    "other"
                  ],
                  "type": "string",
                  "description": "currency | xp | item | other. Makes this a reward chip — send it on every reward."
                },
                "unit": {
                  "type": "string",
                  "description": "currency chips: the coin, as the campaign's setting names it (e.g. coin.gp), or free text such as 'gold'."
                },
                "label": {
                  "type": "string",
                  "description": "What the chip says: an item's name, a favour, a title."
                },
                "notes": {
                  "type": "string",
                  "description": "Retired reward row: notes."
                },
                "amount": {
                  "type": "number",
                  "description": "How many: coins, experience points, a stack."
                },
                "hidden": {
                  "type": "boolean",
                  "description": "true hides the chip from players, false shows it; omitted keeps what it has (a new one is shown)."
                },
                "itemId": {
                  "type": "string",
                  "description": "Retired reward row: a free-text item reference."
                },
                "entryId": {
                  "type": "string",
                  "description": "item chips: the mnemon entry it links to (entryId or exact title). Not with ruleEntryId."
                },
                "unitLabel": {
                  "type": "string",
                  "description": "How the coin reads, e.g. 'Gold piece'."
                },
                "rewardType": {
                  "type": "string",
                  "description": "Retired reward row, without kind: Gold | Item | XP | Reputation …"
                },
                "ruleEntryId": {
                  "type": "string",
                  "description": "item chips: the rules-library entry it links to. Not with entryId."
                },
                "linkedStepIds": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Retired reward row: the stepIds or subquest entry ids that unlock it."
                }
              },
              "additionalProperties": false
            },
            "description": "Replaces the reward chips; an empty list clears them. Name an existing chip by id to keep it."
          },
          "expiresAt": {
            "type": "string",
            "description": "Retired quest board field (ISO-8601)."
          },
          "background": {
            "type": "string",
            "description": "Replaces the Background section, in Markdown."
          },
          "issuerText": {
            "type": "string",
            "description": "Retired quest board field: write it into background."
          },
          "locationId": {
            "type": "string",
            "description": "Where the quest is given or set: a Location's entryId or exact title. On update an empty string removes it."
          },
          "objectives": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "text"
              ],
              "properties": {
                "id": {
                  "type": "string",
                  "description": "The objective to rewrite, as get_mnemon's quest.objectives[].id names it. Omit for a new objective."
                },
                "text": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The objective, one line of Markdown. Mentions: @[label](mnemon:<entryId>)."
                },
                "state": {
                  "enum": [
                    "open",
                    "done",
                    "failed"
                  ],
                  "type": "string",
                  "description": "open (the default), done or failed."
                },
                "hidden": {
                  "type": "boolean",
                  "description": "true hides it from players, false shows it; omitted keeps what it has (a new one is shown)."
                },
                "children": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "required": [
                      "text"
                    ],
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "The objective to rewrite, as get_mnemon's quest.objectives[].id names it. Omit for a new objective."
                      },
                      "text": {
                        "type": "string",
                        "minLength": 1,
                        "description": "The objective, one line of Markdown. Mentions: @[label](mnemon:<entryId>)."
                      },
                      "state": {
                        "enum": [
                          "open",
                          "done",
                          "failed"
                        ],
                        "type": "string",
                        "description": "open (the default), done or failed."
                      },
                      "hidden": {
                        "type": "boolean",
                        "description": "true hides it from players, false shows it; omitted keeps what it has (a new one is shown)."
                      },
                      "optional": {
                        "type": "boolean",
                        "description": "An optional objective does not count toward the quest's progress. Defaults to false."
                      }
                    },
                    "additionalProperties": false
                  },
                  "description": "Its sub-objectives, in order. Omitted keeps the ones it has; an empty list removes them."
                },
                "optional": {
                  "type": "boolean",
                  "description": "An optional objective does not count toward the quest's progress. Defaults to false."
                }
              },
              "additionalProperties": false
            },
            "description": "Replaces the objective list. Name an existing objective by id to keep it and what the GM wrote under it; one left out is removed. To tick one objective, use set_quest_objective_state instead."
          },
          "repeatable": {
            "type": "boolean",
            "description": "Retired quest board field."
          },
          "visibility": {
            "enum": [
              "HIDDEN",
              "INTERNAL",
              "PUBLIC"
            ],
            "type": "string"
          },
          "questStatus": {
            "type": "string",
            "description": "Retired: send status."
          },
          "parentQuestId": {
            "type": "string",
            "description": "The quest this one belongs to: a Quest's entryId or exact title. On update an empty string removes it."
          },
          "playersCanTick": {
            "type": "boolean",
            "description": "Whether players may tick the objectives they can see. Off by default."
          },
          "issuerNpcEntryId": {
            "type": "string",
            "description": "Retired quest board field: send giverId."
          },
          "subQuestEntryIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "This quest's subquests (entryIds or titles). Prefer parentQuestId on each subquest."
          },
          "relatedNpcEntryIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "NPCs the quest involves (entryIds or titles)."
          },
          "relatedLocationEntryIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Locations the quest involves (entryIds or titles)."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1
    },
    "campaignId": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

update_session

Reschedule a campaign session or edit its title/description. All fields optional. Owner-only on the backend.

Argument	Type	Description
endAt	string	ISO-8601 instant.
title	string
startAt	string	ISO-8601 instant.
sessionId*	string	Session ID.
campaignId*	string	Campaign ID.
description	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "sessionId"
  ],
  "properties": {
    "endAt": {
      "type": "string",
      "description": "ISO-8601 instant."
    },
    "title": {
      "type": "string"
    },
    "startAt": {
      "type": "string",
      "description": "ISO-8601 instant."
    },
    "sessionId": {
      "type": "string",
      "minLength": 1,
      "description": "Session ID."
    },
    "campaignId": {
      "type": "string",
      "minLength": 1,
      "description": "Campaign ID."
    },
    "description": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

update_session_summary_mnemons

Update the recap, date, number and meta fields of SessionSummary mnemons. To change the story, use update_mnemons_content.

Argument	Type	Description
items*	array
campaignId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaignId",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "entryId"
        ],
        "properties": {
          "date": {
            "type": "string",
            "description": "When the session was played: ISO date (2024-02-10) or date-time. Set it for a past chapter brought into Argo. Leave it out for a summary linked to a calendar session: it then takes the session's date. Linking never clears it. An empty string clears it."
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "recap": {
            "type": "string",
            "description": "Short recap, 1-3 sentences, ending on where the party stands. Shown as \"Previously on\" on the next session and the campaign Dashboard. The full story goes in the Markdown body."
          },
          "title": {
            "type": "string"
          },
          "entryId": {
            "type": "string",
            "minLength": 1,
            "description": "Mnemon entry id (hex) or exact title."
          },
          "visibility": {
            "enum": [
              "HIDDEN",
              "INTERNAL",
              "PUBLIC"
            ],
            "type": "string"
          },
          "sessionNumber": {
            "type": "integer",
            "description": "The session's number in the party's history, a positive whole number, kept as written. Leave it out to let Argo number the summary by its place in the history (after the highest number before it). Linking never clears it. 0 clears it."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1
    },
    "campaignId": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}