AvatarSay — Fictional Character, RPG NPC & Talking Video MCP

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

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
83%
Naming quality
98%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,647Tokens (tool definitions)
~1.6 KBTypical response size
Significant attention impact (2.07% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

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

Runnable packages

npmavatarsay-mcp1.2.0stdio

Remote endpoints

https://avatarsay.com/mcpstreamable-http

What it can do

Tool inventory

Tools (10)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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.

Input 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.

Input 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_...

Input 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_...

Input 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_...

Input 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_...

Input 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_...

Input 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_...

Input 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_...

Input 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_...

Input 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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded10 tools