Skip to main content
Glama

create_live_avatar

Save a real live conversational avatar draft from a supplied or generated image and a real catalog voice (or supplied custom voice reference). Uses shared Anima defaults: HD (fast), square, Tempo listening, visual stability 0.81, motion freedom 0.95. SD is currently unavailable. Preserve explicit format, mode and animation choices. Creates privately with public embedding disabled. Does not start a call. Prepare the returned character ID next.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "workspaceId": "<workspaceId>",
      "name": "<name>",
      "avatarImageUrl": "<avatarImageUrl>",
      "systemPrompt": "<systemPrompt>"
    },
    "name": "create_live_avatar"
  }
}

Input Schema

NameRequiredDescriptionDefault
nameYes
cerebroNo
languageNo
animaModeNoSD is currently unavailable. Use fast for HD, or max for Max.
descriptionNo
orientationNo
voiceSourceNo
workspaceIdYes
openingLinesNo
systemPromptYes
knowledgeTextNo
avatarImageUrlYes
providerVoiceIdNo
voiceDescriptionNo
maxSessionSecondsNo
voiceReferenceUrlNo
baseAnimationQualityNoAvatar mode. New avatars default to Premium.
avatarImageStoragePathNo
avatarAnimationSettingsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / baseAnimationQuality / description
      Previous value: -"Premium uses Gemini Omni for base motion. Efficient uses native Anima motion. New avatars default to Premium."New value: +"Avatar mode. New avatars default to Premium."
  2. Changed1 schema field changed
    • addedInput schema / properties / baseAnimationQuality
      Added value: +{
      +  "description": "Premium uses Gemini Omni for base motion. Efficient uses native Anima motion. New avatars default to Premium.",
      +  "enum": [
      +    "premium",
      +    "efficient"
      +  ],
      +  "type": "string"
      +}
  3. Changed2 schema fields changed
    • addedInput schema / properties / animaMode / description
      Added value: +"SD is currently unavailable. Use fast for HD, or max for Max."
    • changedInput schema / properties / animaMode / enum
      Previous value: -[
      -  "fast",
      -  "max"
      -]New value: +[
      +  "sd",
      +  "fast",
      +  "max"
      +]
  4. Changed2 schema fields changed
    • addedInput schema / properties / cerebro
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "personalityTraits": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "agreeableness": {
      +          "maximum": 100,
      +          "minimum": 0,
      +          "type": "number"
      +        },
      +        "conscientiousness": {
      +          "maximum": 100,
      +          "minimum": 0,
      +          "type": "number"
      +        },
      +        "emotionalStability": {
      +          "maximum": 100,
      +          "minimum": 0,
      +          "type": "number"
      +        },
      +        "extraversion": {
      +          "maximum": 100,
      +          "minimum": 0,
      +          "type": "number"
      +        },
      +        "openness": {
      +          "maximum": 100,
      +          "minimum": 0,
      +          "type": "number"
      +        },
      +        "playfulness": {
      +          "maximum": 100,
      +          "minimum": 0,
      +          "type": "number"
      +        }
      +      },
      +      "required": [
      +        "openness",
      +        "conscientiousness",
      +        "extraversion",
      +        "agreeableness",
      +        "emotionalStability",
      +        "playfulness"
      +      ],
      +      "type": "object"
      +    },
      +    "schemaVersion": {
      +      "const": "sequencer.liveCharacter.cerebro.v1",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "schemaVersion",
      +    "personalityTraits"
      +  ],
      +  "type": "object"
      +}
    • addedInput schema / properties / maxSessionSeconds
      Added value: +{
      +  "maximum": 3600,
      +  "minimum": 30,
      +  "type": "integer"
      +}
  5. Added

TDQS

A3.6/5.0
Behavior4/5

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

Beyond the annotations, the description discloses real behavioral facts: private creation with public embedding disabled, no call started, the shared Anima defaults (HD fast, square, Tempo listening, stability 0.81, motion freedom 0.95), and the unavailability of SD. It does not mention that the call is non-idempotent, i.e. that repeating it creates duplicate avatars, which is the main remaining behavioral gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The definition is short and front-loads the core action, defaults and constraints in a dense sequence of sentences. A couple of fragments ('Prepare the returned character ID next.') read as clipped notes rather than complete guidance, but there is little wasted wording.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 19-parameter, nested-object creation tool with no output schema and very low schema coverage, the description covers the defaults and privacy posture but omits most of the substantive inputs an agent must supply. It is adequate to call the tool, not sufficient to call it well.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 11% across 19 parameters, so the description carries most of the burden. It usefully explains the animaMode/HD-fast and SD-unavailable constraint, the square orientation default, the voice source choice, and the animation-setting defaults, but leaves cerebro personality traits, systemPrompt, openingLines, knowledgeText, language, maxSessionSeconds and the storage-path fields entirely unexplained.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description gives a concrete verb and resource: saving a live conversational avatar draft from an image plus a catalog or custom voice reference. It also distinguishes itself from the session-starting siblings with 'Does not start a call,' though it never names update_live_avatar or prepare_live_avatar as the nearest alternatives.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied rather than stated: 'Prepare the returned character ID next' and 'Does not start a call' sketch a workflow, and 'Preserve explicit format, mode and animation choices' hints at caller responsibility. There is no explicit statement of when to create a new avatar versus updating an existing one, nor any prerequisite guidance.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.