AvatarSay — Fictional Character, RPG NPC & Talking Video MCP
Roll RPG NPCs (Foundry VTT & SillyTavern V2), import stylized art, MP3 barks & talking MP4s.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"avatarsay-mcp": {
"command": "npx",
"args": [
"avatarsay-mcp"
]
}
}
}실행 가능한 패키지
1.2.0stdio원격 엔드포인트
https://avatarsay.com/mcpstreamable-http할 수 있는 일
도구 목록
도구 (10)
🟢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.
입력 스키마
{
"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.
입력 스키마
{
"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_...
입력 스키마
{
"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_...
입력 스키마
{
"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_...
입력 스키마
{
"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_...
입력 스키마
{
"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_...
입력 스키마
{
"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_...
입력 스키마
{
"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_...
입력 스키마
{
"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_...
입력 스키마
{
"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
}커뮤니티
증거