AvatarSay — Fictional Character, RPG NPC & Talking Video MCP

Roll RPG NPCs (Foundry VTT & SillyTavern V2), import stylized art, MP3 barks & talking MP4s.

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
100%
Vollständigkeit des Schemas
83%
Qualität der Benennung
98%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~2,647Tokens (Tool-Definitionen)
~1.6 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (2.07% von 128k Kontext)

Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.

Installieren

Installation mit einem Klick

Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:

{
  "mcpServers": {
    "avatarsay-mcp": {
      "command": "npx",
      "args": [
        "avatarsay-mcp"
      ]
    }
  }
}

Ausführbare Pakete

npmavatarsay-mcp1.2.0stdio

Remote-Endpunkte

https://avatarsay.com/mcpstreamable-http

Was es kann

Tool-Inventar

Tools (10)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢list_voices_and_styles

Return all 8 AvatarSay visual styles, all 8 built-in English TTS voices (with audio sample URLs), per-action credit costs (including first free 5s talking clip and 2-credit NPC voice lines), and one-time credit pack pricing. Public read-only tool — does not require an API key.

Eingabe-Schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
🟢roll_rpg_npc(seed, style, gender, ancestry, role, ...)

Deterministically roll a complete tabletop RPG / D&D NPC (name, ancestry, role, traits, quirk, plot hook, GM secret, portrait prompt, matched voice sample MP3, and a <=75-char greeting tuned for the free 5s talking video clip), plus ready-to-import SillyTavern Character Card V2 JSON and Foundry VTT NPC Actor JSON. Public zero-cost tool — requires NO API key and charges 0 credits.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "seed": {
      "type": "string",
      "maxLength": 32,
      "description": "Optional deterministic seed (e.g. \"forge26a\" or \"42\"). Same seed always produces the exact same NPC; omit to roll a fresh random seed."
    },
    "style": {
      "type": "string",
      "enum": [
        "anime",
        "3d-cartoon",
        "pixel-art",
        "realistic",
        "professional-headshot",
        "fantasy",
        "watercolor",
        "cyberpunk",
        "cartoon",
        "3d"
      ],
      "description": "Visual portrait style preset (default \"fantasy\"). Supports fantasy, anime, 3d-cartoon (or aliases cartoon / 3d), pixel-art, cyberpunk, watercolor, realistic, professional-headshot."
    },
    "gender": {
      "type": "string",
      "enum": [
        "f",
        "m"
      ],
      "description": "Optional character presentation filter: \"f\" (feminine) or \"m\" (masculine)."
    },
    "ancestry": {
      "type": "string",
      "maxLength": 60,
      "description": "Optional ancestry filter or custom ancestry, e.g. \"Dwarven\", \"Elven\", \"Half-orc\", \"Halfling\", \"Gnomish\", \"Fey-touched\", \"Tiefling\"."
    },
    "role": {
      "type": "string",
      "maxLength": 80,
      "description": "Optional tabletop role filter or custom archetype, e.g. \"Tavern keeper\", \"Runesmith\", \"Hedge alchemist\", \"Harbor smuggler\", \"Wandering bard\"."
    },
    "exportFormat": {
      "type": "string",
      "enum": [
        "all",
        "summary",
        "sillytavern",
        "foundry"
      ],
      "description": "Output export format: \"all\" (default, includes both SillyTavern Character Card V2 and Foundry VTT Actor JSON), \"summary\", \"sillytavern\", or \"foundry\"."
    }
  },
  "additionalProperties": false
}
🟢get_credits

Return the authenticated AvatarSay account email, current non-expiring credit balance, image quality tier (standard vs hd), whether the 0-credit first talking video clip is still available, and how many avatar generations, NPC voice lines, or video seconds the balance covers. Requires Authorization: Bearer avs_...

Eingabe-Schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
🟢list_avatars(limit)

List recent fictional character avatars (both AI-generated portraits and imported stylized character illustrations) in this AvatarSay account, including assetId (ast_...) and 24-hour signed download URLs, ready to animate with create_talking_video. Requires Authorization: Bearer avs_...

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 24,
      "description": "Maximum number of recent avatar images to return (1–24, default 12)."
    }
  },
  "additionalProperties": false
}
🟡import_character_portrait(imageUrl, imageBase64, label, confirmFictional)

Import an existing non-photorealistic fictional character illustration (anime, 2D/3D cartoon, pixel art, fantasy digital painting, VTT token art; PNG/JPG/WebP, 256–4096 px, max 5 MB) from an https:// URL or base64 data URI for 0 credits, returning an assetId (ast_...) ready for create_talking_video. Camera photographs and photorealistic human likenesses are strictly blocked by EXIF and automated vision screening. Requires confirmFictional=true and Authorization: Bearer avs_...

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "imageUrl": {
      "type": "string",
      "maxLength": 2048,
      "description": "Public https:// URL of a PNG, JPG, or WebP stylized character illustration (max 5 MB). Provide either imageUrl or imageBase64."
    },
    "imageBase64": {
      "type": "string",
      "description": "Base64-encoded PNG, JPG, or WebP character illustration (raw base64 or data:image/...;base64,... URI, max 5 MB). Provide either imageUrl or imageBase64."
    },
    "label": {
      "type": "string",
      "maxLength": 160,
      "description": "Optional character name or short description (up to 160 chars), e.g. \"Bramwell Copperbraid — Dwarven Runesmith\"."
    },
    "confirmFictional": {
      "type": "boolean",
      "description": "Must be true: confirms this image is a fictional, stylized character illustration and NOT a photograph or likeness of a real person."
    }
  },
  "required": [
    "confirmFictional"
  ],
  "additionalProperties": false
}
🟢list_videos(limit)

List recent watermark-free talking avatar MP4 videos (960×960) already rendered in this AvatarSay account, including assetId (ast_v_...), spoken script, and 24-hour signed stream & download URLs. Requires Authorization: Bearer avs_...

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 24,
      "description": "Maximum number of recent talking videos to return (1–24, default 12)."
    }
  },
  "additionalProperties": false
}
🟢generate_avatars(prompt, style)

Generate 2 square (1024×1024) fictional character portraits from a text description in one of 8 art styles. Costs 4 credits (Standard) or 6 credits (HD for accounts that have purchased a pack). Enqueues asynchronously and returns jobId immediately — call get_job after ~5–10 seconds to get the 2 assetIds and signed image URLs. Requires Authorization: Bearer avs_...

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "minLength": 3,
      "maxLength": 500,
      "description": "Visual description of an original fictional character (3–500 chars), e.g. \"weathered dwarven blacksmith with copper braids and glowing forge goggles\". Avoid real people, celebrities, or explicit content."
    },
    "style": {
      "type": "string",
      "enum": [
        "anime",
        "3d-cartoon",
        "pixel-art",
        "realistic",
        "professional-headshot",
        "fantasy",
        "watercolor",
        "cyberpunk"
      ],
      "description": "Art style preset ID: anime, 3d-cartoon, pixel-art, realistic, professional-headshot, fantasy, watercolor, cyberpunk."
    }
  },
  "required": [
    "prompt",
    "style"
  ],
  "additionalProperties": false
}
🟡create_npc_voice_line(script, voiceId, speed, emotion)

Synthesize an instant (<3s) English character voice bark or tabletop NPC dialogue MP3 (1–500 chars) in one of 8 preset voices with optional speed and emotion control. Costs 2 credits per 100 characters (minimum 2 credits — a new 30-credit account can generate 15 tabletop MP3 barks free). Returns a 24-hour signed MP3 download URL immediately. Requires Authorization: Bearer avs_...

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "script": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "English spoken dialogue line (1–500 chars)."
    },
    "voiceId": {
      "type": "string",
      "enum": [
        "Friendly_Person",
        "Wise_Woman",
        "Lively_Girl",
        "Calm_Woman",
        "Casual_Guy",
        "Deep_Voice_Man",
        "Patient_Man",
        "Young_Knight"
      ],
      "description": "Built-in English voice ID: Friendly_Person, Wise_Woman, Lively_Girl, Calm_Woman, Casual_Guy, Deep_Voice_Man, Patient_Man, Young_Knight."
    },
    "speed": {
      "type": "number",
      "minimum": 0.8,
      "maximum": 1.2,
      "description": "Optional speech speed multiplier (0.8–1.2, default 1.0)."
    },
    "emotion": {
      "type": "string",
      "enum": [
        "neutral",
        "happy",
        "angry",
        "sad",
        "fearful",
        "surprised"
      ],
      "description": "Optional vocal emotion delivery: neutral, happy, angry, sad, fearful, surprised (default \"neutral\")."
    }
  },
  "required": [
    "script",
    "voiceId"
  ],
  "additionalProperties": false
}
🟡create_talking_video(assetId, script, voice)

Animate an AvatarSay character avatar (ast_...) with lip-synced English speech in one of 8 preset voices. New accounts get their first short talking clip (<=5s / <=75 chars) for 0 credits! Subsequent or longer clips cost 12 account credits per second of speech (minimum 5s = 60 credits, maximum 30s). Enqueues asynchronously and returns jobId immediately — never blocks for the 3–5 minute render. Poll get_job every 20–30 seconds for the watermark-free 960×960 MP4 URL. Failed renders refund credits automatically. Requires Authorization: Bearer avs_...

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "assetId": {
      "type": "string",
      "minLength": 5,
      "maxLength": 64,
      "description": "AvatarSay character asset ID (ast_...) from generate_avatars -> get_job, import_character_portrait, or list_avatars. Camera photos of real people are not supported."
    },
    "script": {
      "type": "string",
      "minLength": 2,
      "maxLength": 400,
      "description": "English spoken dialogue line (2–400 chars, up to 30 seconds of speech; <=75 chars qualifies for the 0-credit first clip on new accounts)."
    },
    "voice": {
      "type": "string",
      "enum": [
        "Friendly_Person",
        "Wise_Woman",
        "Lively_Girl",
        "Calm_Woman",
        "Casual_Guy",
        "Deep_Voice_Man",
        "Patient_Man",
        "Young_Knight"
      ],
      "description": "Built-in English voice ID: Friendly_Person, Wise_Woman, Lively_Girl, Calm_Woman, Casual_Guy, Deep_Voice_Man, Patient_Man, Young_Knight."
    }
  },
  "required": [
    "assetId",
    "script",
    "voice"
  ],
  "additionalProperties": false
}
🟢get_job(jobId)

Check the status (queued, running, succeeded, failed) of an image or talking-video job (job_...) and return 24-hour signed download URLs once succeeded, or refund details if failed. Requires Authorization: Bearer avs_...

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "jobId": {
      "type": "string",
      "minLength": 5,
      "maxLength": 64,
      "description": "Job ID (job_...) returned by generate_avatars or create_talking_video."
    }
  },
  "required": [
    "jobId"
  ],
  "additionalProperties": false
}

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet10 Tools