AvatarSay — Fictional Character, RPG NPC & Talking Video MCP

● Active

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

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

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>"
      }
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --env AVATARSAY_API_KEY='<your AVATARSAY_API_KEY>' --transport stdio avatarsay-mcp -- npx -y avatarsay-mcp@1.2.0
OpenAI Codex CLI
codex mcp add avatarsay-mcp --env AVATARSAY_API_KEY='<your AVATARSAY_API_KEY>' -- npx -y avatarsay-mcp@1.2.0
VS Code
code --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.

Environment variables
  • 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
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Looks 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 →
● Working91 msprotocol 2025-06-18v1.2.0toolspromptsresources

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_styles

    Return 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 params

    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.

    Show 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, pr
    • genderstringOptional 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_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_...

  • list_avatars1 param

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

    Show parameters
    • limitintegerMaximum number of recent avatar images to return (1–24, default 12).
  • import_character_portrait4 params

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

    Show 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 param

    List 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 parameters
    • limitintegerMaximum number of recent talking videos to return (1–24, default 12).
  • generate_avatars3 params

    Generate 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 parameters
    • promptstringrequiredVisual description of an original fictional character (3–500 chars), e.g. "weathered dwarven blacksmith with copper braids and glowing forge goggles". Avoid rea
    • stylestringrequiredArt 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 params

    Synthesize 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 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, Japane
    • speednumberOptional 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 params

    Animate 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 parameters
    • assetIdstringrequiredAvatarSay character asset ID (ast_...) from generate_avatars -> get_job, import_character_portrait, or list_avatars. Camera photos of real people are not suppor
    • scriptstringrequiredSpoken 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, Japane
    • qualityModestringOptional 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 param

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

    Show 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-httphttps://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.

ServerStarsLast pushLive check
HyperFrames by HeyGen87,943Nov 2026Needs sign-in
HyperFrames by HeyGen86,475Nov 2026Needs sign-in
Pascal 3D Editor25,651Nov 2026Needs sign-in
screenpipe22,421Nov 2026Local / not checked
FunASR21,097Nov 2026Local / 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.
Browse all Media & Creative →

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.

AvatarSay — Fictional Character, RPG NPC & Talking Video MCP — listed on Serverdex

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

[![AvatarSay — Fictional Character, RPG NPC & Talking Video MCP — listed on Serverdex](https://serverdex.io/brand/badge.svg)](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.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-fourgit-avatarsay-mcp) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-fourgit-avatarsay-mcp) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](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).