AvatarSay — Fictional Character, RPG NPC & Talking Video MCP
● Activeio.github.fourgit/avatarsay-mcp
Roll RPG NPCs (Foundry VTT & SillyTavern V2), import stylized art, MP3 barks & talking MP4s.
Connect this server
One click to install, or copy the config below. Suits: Claude Desktop · Cursor.
Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):
{
"mcpServers": {
"avatarsay-mcp": {
"command": "npx",
"args": [
"-y",
"avatarsay-mcp@1.2.0"
],
"env": {
"AVATARSAY_API_KEY": "<your AVATARSAY_API_KEY>"
}
}
}
}claude mcp add --env AVATARSAY_API_KEY='<your AVATARSAY_API_KEY>' --transport stdio avatarsay-mcp -- npx -y avatarsay-mcp@1.2.0codex mcp add avatarsay-mcp --env AVATARSAY_API_KEY='<your AVATARSAY_API_KEY>' -- npx -y avatarsay-mcp@1.2.0code --add-mcp '{"name":"avatarsay-mcp","type":"stdio","command":"npx","args":["-y","avatarsay-mcp@1.2.0"],"env":{"AVATARSAY_API_KEY":"<your AVATARSAY_API_KEY>"}}'Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.
- AVATARSAY_API_KEYsecretOptional for discovery & roll_rpg_npc; required for generation tools: avs_YOUR_API_KEY (from https://avatarsay.com/dashboard#mcp)
A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.
- Category
- Media & Creative
- Version
- 1.2.1
- Registry
- active
- Published
- 11/15/2026
Is it safe? Is it maintained?
Serverdex check: Nov 22, 2026Looks healthy: AvatarSay — Fictional Character, RPG NPC & Talking Video MCP is maintained, open source, hosted endpoint answering without a key.
- Maintained
- Active
- Last commit 2 days ago (Nov 20, 2026), 2 open issues.
- Official registry
- Active
- Published as io.github.fourgit/avatarsay-mcp in the official MCP registry, version 1.2.1.
- Source
- Open source, MIT
- Public repository under the MIT licence, 0 stars, 0 forks.
- Runs
- Local package or hosted
- Ships as a local package (npm) that runs on your machine, and as a hosted endpoint at avatarsay.com that receives what your client sends it.
- Credentials
- None needed to connect
- The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
- Owner
- Unclaimed
- Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.
Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.
Live check
checked Nov 22, 2026, 02:09 UTCStatus history & uptime →The endpoint answered the MCP handshake as "AvatarSay — Fictional Character, RPG NPC & Talking Video MCP Server" and listed 10 tools. Answering since Nov 17, 2026.
Context cost ≈ 3.3k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 10 tools.
Tools (10)
list_voices_and_stylesReturn all 8 AvatarSay visual styles, all 8 built-in multilingual TTS voices (40+ languages, with audio sample URLs), supported language_boost values, 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.
roll_rpg_npc6 paramsDeterministically 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.
Show parametersHide parameters
seedstringOptional deterministic seed (e.g. "forge26a" or "42"). Same seed always produces the exact same NPC; omit to roll a fresh random seed.stylestringVisual portrait style preset (default "fantasy"). Supports fantasy, anime, 3d-cartoon (or aliases cartoon / 3d), pixel-art, cyberpunk, watercolor, realistic, prgenderstringOptional character presentation filter: "f" (feminine) or "m" (masculine).ancestrystringOptional ancestry filter or custom ancestry, e.g. "Dwarven", "Elven", "Half-orc", "Halfling", "Gnomish", "Fey-touched", "Tiefling".rolestringOptional tabletop role filter or custom archetype, e.g. "Tavern keeper", "Runesmith", "Hedge alchemist", "Harbor smuggler", "Wandering bard".exportFormatstringOutput export format: "all" (default, includes both SillyTavern Character Card V2 and Foundry VTT Actor JSON), "summary", "sillytavern", or "foundry".
get_creditsReturn 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_...
list_avatars1 paramList 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_...
Show parametersHide parameters
limitintegerMaximum number of recent avatar images to return (1–24, default 12).
import_character_portrait4 paramsImport 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_...
Show parametersHide parameters
imageUrlstringPublic https:// URL of a PNG, JPG, or WebP stylized character illustration (max 5 MB). Provide either imageUrl or imageBase64.imageBase64stringBase64-encoded PNG, JPG, or WebP character illustration (raw base64 or data:image/...;base64,... URI, max 5 MB). Provide either imageUrl or imageBase64.labelstringOptional character name or short description (up to 160 chars), e.g. "Bramwell Copperbraid — Dwarven Runesmith".confirmFictionalbooleanrequiredMust be true: confirms this image is a fictional, stylized character illustration and NOT a photograph or likeness of a real person.
list_videos1 paramList recent watermark-free talking avatar MP4 videos (9:16 720×1280, 1:1 960×960, or 16:9 1280×720 in Studio HD; 480×864 / 864×480 / 480×480 in Fast Preview) already rendered in this AvatarSay account, including assetId (ast_v_...), spoken script, and 24-hour signed stream & download URLs. Requires Authorization: Bearer avs_...
Show parametersHide parameters
limitintegerMaximum number of recent talking videos to return (1–24, default 12).
generate_avatars3 paramsGenerate 2 fictional character portraits (1:1, 9:16, or 16:9) 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_...
Show parametersHide parameters
promptstringrequiredVisual description of an original fictional character (3–500 chars), e.g. "weathered dwarven blacksmith with copper braids and glowing forge goggles". Avoid reastylestringrequiredArt style preset ID: anime, 3d-cartoon, pixel-art, realistic, professional-headshot, fantasy, watercolor, cyberpunk.aspectRatiostringOptional aspect ratio: 1:1, 9:16, 16:9 (default "1:1").
create_npc_voice_line5 paramsSynthesize an instant (<3s) multilingual (40+ languages) character voice bark or tabletop NPC dialogue MP3 (1–500 chars) in one of 8 preset voices with optional language, 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_...
Show parametersHide parameters
scriptstringrequiredSpoken dialogue line in any supported language (1–500 chars).voiceIdstringrequiredBuilt-in multilingual voice ID: Friendly_Person, Wise_Woman, Lively_Girl, Calm_Woman, Casual_Guy, Deep_Voice_Man, Patient_Man, Young_Knight.languagestringOptional language hint for pronunciation (default "auto", supporting 40+ languages): auto, English, Russian, French, Spanish, German, Arabic, Portuguese, JapanespeednumberOptional speech speed multiplier (0.8–1.2, default 1.0).emotionstringOptional vocal emotion delivery: neutral, happy, angry, sad, fearful, surprised (default "neutral").
create_talking_video5 paramsAnimate an AvatarSay character avatar (ast_...) with lip-synced speech in 40+ languages using one of 8 preset voices. New accounts get their first short talking clip (<=5s / <=75 chars) for 0 credits in Fast Preview (~15–30s via VEED Fabric 1.0 Fast)! Subsequent or longer clips cost 12 account credits per second of speech (minimum 5s = 60 credits, maximum 30s) in Fast Preview (~15–30s) or Studio HD (~2–4 min via Kling AI Avatar v2 Standard, 720×1280 / 960×960 / 1280×720 MP4). Enqueues asynchronously and returns jobId immediately. Poll get_job for the watermark-free MP4 URL. Failed renders refund credits automatically. Requires Authorization: Bearer avs_...
Show parametersHide parameters
assetIdstringrequiredAvatarSay character asset ID (ast_...) from generate_avatars -> get_job, import_character_portrait, or list_avatars. Camera photos of real people are not supporscriptstringrequiredSpoken dialogue line in any supported language (2–400 chars, up to 30 seconds of speech; <=75 chars qualifies for the 0-credit first clip on new accounts).voicestringrequiredBuilt-in multilingual voice ID: Friendly_Person, Wise_Woman, Lively_Girl, Calm_Woman, Casual_Guy, Deep_Voice_Man, Patient_Man, Young_Knight.languagestringOptional language hint for pronunciation (default "auto", supporting 40+ languages): auto, English, Russian, French, Spanish, German, Arabic, Portuguese, JapanequalityModestringOptional render mode: "fast" (480×864 / 864×480 / 480×480, ~15–30s; required for 0-credit free trial) or "hd" (Studio HD 720×1280 / 1280×720 / 960×960, ~2–4m; d
get_job1 paramCheck 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_...
Show parametersHide parameters
jobIdstringrequiredJob ID (job_...) returned by generate_avatars or create_talking_video.
Checked by Serverdex with a plain initialize + tools/list call to avatarsay.com/mcp, no credentials, about once a day. A failed check is never a removal.
On GitHub
read Nov 22, 2026- Stars
- 0
- Forks
- 0
- Last push
- Nov 20, 2026
- License
- MIT
JavaScriptclaudecursormcpmcp-servermodel-context-protocolrpg-npctalking-avatar
From the README
AvatarSay MCP Server (v1.2.0) Roll complete tabletop RPG / D&D NPCs (SillyTavern Character Card V2 + Foundry VTT Actor JSON), import your existing non-photorealistic character illustrations & VTT tokens, synthesize fast (<3s) tabletop MP3 voice barks, generate original fictional character portraits (2 × 1024 px in 8 styles: Anime, 3D Cartoon, Pixel Art, Fantasy, Cyberpunk, Watercolor, Realistic, Professional), and animate them into lip-synced square talking videos (960×960 H.264 MP4, 8 built-in English voices, zero watermark) directly from Claude Desktop, Claude Code, Cursor, Windsurf, or any Model Context Protocol (MCP) client. • Remote MCP Endpoint (recommended, zero install): https://avatarsay.com/mcp • Setup Guide & Live Docs: https://avatarsay.com/mcp • API Keys: https://avatarsay.com/dashboard#mcp • Free Trial & Pay-Once Pricing: • Public zero-key NPC roller: rollrpgnpc and listvoicesand_styles run at 0 credits with no API key required. • 30 free signup credits + 1 free talking MP4 via MCP: New accounts receive 30 free credits (up to 7 portrait pairs = 14 avatars, or 15 instant .mp3 NPC voice barks at 2 credits each) plus 1 free <=5s (<=75-char) talking MP4 clip (0 credits via MCP or web, zero watermark). • No subscription: One-time credit packs start at $9.90 for 500 credits and never expire (pricing details). Quick Start (Zero-Install Remote HTTP) Modern MCP clients connect directly to https://avatarsay.com/mcp via Streamable HTTP — no local runtime needed.…
Read the full README on GitHub →Remotes
- streamable-http
https://avatarsay.com/mcp
Alternatives to AvatarSay — Fictional Character, RPG NPC & Talking Video MCP
All AvatarSay — Fictional Character, RPG NPC & Talking Video MCP alternatives →Best Media & Creative servers →The most-starred Media & Creative servers in the index, with their live-check result.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| HyperFrames by HeyGen | 87,943 | Nov 2026 | Needs sign-in |
| HyperFrames by HeyGen | 86,475 | Nov 2026 | Needs sign-in |
| Pascal 3D Editor | 25,651 | Nov 2026 | Needs sign-in |
| screenpipe | 22,421 | Nov 2026 | Local / not checked |
| FunASR | 21,097 | Nov 2026 | Local / not checked |
AvatarSay — Fictional Character, RPG NPC & Talking Video MCP: questions people ask
- Is AvatarSay — Fictional Character, RPG NPC & Talking Video MCP a remote or a local MCP server?
- According to its entry in the official MCP registry, AvatarSay — Fictional Character, RPG NPC & Talking Video MCP ships as a hosted endpoint (streamable-http) that your client connects to by URL and as a local package (npm) that your client starts on your machine. Use the hosted endpoint when your client supports Streamable HTTP; use the package when you want it to run locally.
- Does AvatarSay — Fictional Character, RPG NPC & Talking Video MCP need an API key?
- Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
- Is AvatarSay — Fictional Character, RPG NPC & Talking Video MCP safe to use?
- Looks healthy: AvatarSay — Fictional Character, RPG NPC & Talking Video MCP is maintained, open source, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: Local package or hosted; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
- Is AvatarSay — Fictional Character, RPG NPC & Talking Video MCP still maintained?
- Active: the repository's last commit 2 days ago. Last push Nov 20, 2026, 0 GitHub stars, MIT licence. Read from GitHub on Nov 22, 2026.
- What tools does AvatarSay — Fictional Character, RPG NPC & Talking Video MCP expose?
- 10 tools as listed by the server itself during the live check, including list_voices_and_styles, roll_rpg_npc, get_credits, list_avatars, import_character_portrait. The full list with parameters is in the Live check section above.
- How do I add AvatarSay — Fictional Character, RPG NPC & Talking Video MCP to Claude, Cursor or VS Code?
- Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
More Media & Creative servers
Browse all Media & Creative →Chalkcast
FredMichel
Author, render and visually verify Manim math animations from natural language
Shutterstock
fredobumma
Search Shutterstock photos, footage, music and news images; preview, collect and license them.
PixelForge
freema
Forge pixel art sprites, animations, tilesets and game assets with Google Gemini.
FreeVectorIcons
FreeVectorIcons
Read and write a FreeVectorIcons design collection: briefs, DESIGN.md, icons and brand assets.
Fyreflock
FuloxDev
Talk to a real person who passed a live camera check and play 25 games, right in your AI chat.
Kokon
GabrieleLozupone
Generate and edit images offline with Qwen-Image 2.1 on your GPU. Needs the Kokon desktop app.
Add the badge to your site
Show visitors that AvatarSay — Fictional Character, RPG NPC & Talking Video MCP is listed here — it’s also the link we check for a free listing.
HTML — for your website
<a href="https://serverdex.io/server/io-github-fourgit-avatarsay-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="AvatarSay — Fictional Character, RPG NPC & Talking Video MCP — listed on Serverdex" width="123" height="40" loading="lazy"></a>Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.
Markdown — for your README
[](https://serverdex.io/server/io-github-fourgit-avatarsay-mcp?utm_source=badge)Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.
Install buttons — for your README
[](https://serverdex.io/install/cursor/io-github-fourgit-avatarsay-mcp) [](https://serverdex.io/install/vscode/io-github-fourgit-avatarsay-mcp) [](https://serverdex.io/install/claude-code/io-github-fourgit-avatarsay-mcp)One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.
Install buttons — HTML for your docs
<a href="https://serverdex.io/install/cursor/io-github-fourgit-avatarsay-mcp"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-fourgit-avatarsay-mcp"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-fourgit-avatarsay-mcp"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>Same buttons as plain links for a docs page or website.
Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).