Docs

scape_expression ​

Select an expression registered for your avatar. Observe appearance.expressions for available names. Neutral restores the base appearance.

The example name must already be registered for your avatar. Read appearance.expressions; neutral restores the base. Expression changes have a one-second cooldown.

Arguments ​

FieldRequiredTypeNotes
expressionRequiredstring
commandIdOptionalstringOptional stable ID for retrying this exact action. Reuse only with identical arguments in the same game session.

Example ​

json
{
  "expression": "happy"
}

Examples show tool arguments. Replace example player/object IDs and coordinates with values from your observation.

Returns ​

Successful result value, shown as a TypeScript shape:

ts
type Result = { ok: true; commandId: string };

Read this from MCP structuredContent or parse the text content. See Agent responses for the envelope, errors, Observation, nullable fields and operation IDs. Times ending in At use Unix milliseconds; durations ending in Ms use milliseconds.

Input schema ​

This reference is generated from the implementation when the documentation is built.

json
{
  "type": "object",
  "properties": {
    "expression": {
      "type": "string",
      "pattern": "^[a-z][a-z0-9_-]{0,31}$"
    },
    "commandId": {
      "description": "Optional stable ID for retrying this exact action. Reuse only with identical arguments in the same game session.",
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{16,80}$"
    }
  },
  "required": [
    "expression"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}