AvatarSay MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@AvatarSay MCP Server Create an anime detective portrait and a video of her saying hello."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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/mcpSetup Guide & Live Docs: https://avatarsay.com/mcp
API Keys: https://avatarsay.com/dashboard#mcp
Free Trial & Pay-Once Pricing:
Public zero-key NPC roller:
roll_rpg_npcandlist_voices_and_stylesrun 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
.mp3NPC voice barks at 2 credits each) plus 1 free<=5s(<=75-char) talking MP4 clip (0credits 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.
Cursor / Windsurf (.cursor/mcp.json)
{
"mcpServers": {
"avatarsay": {
"url": "https://avatarsay.com/mcp",
"headers": {
"Authorization": "Bearer avs_YOUR_API_KEY"
}
}
}
}Claude Code (CLI)
claude mcp add --transport http avatarsay https://avatarsay.com/mcp \
--header "Authorization: Bearer avs_YOUR_API_KEY"Related MCP server: elevenlabs-mcp
Claude Desktop (stdio Bridge — Zero git Required)
Claude Desktop's claude_desktop_config.json expects a local stdio command. Pass the immutable v1.2.0 GitHub HTTPS tarball URL directly to npx -y — npm fetches the tarball natively over HTTPS with zero git binary dependency and zero npm login:
{
"mcpServers": {
"avatarsay": {
"command": "npx",
"args": [
"-y",
"https://codeload.github.com/fourgit/avatarsay-mcp/tar.gz/refs/tags/v1.2.0"
],
"env": {
"AVATARSAY_API_KEY": "avs_YOUR_API_KEY"
}
}
}
}(You can omit AVATARSAY_API_KEY if you only want public discovery and roll_rpg_npc.)
Tabletop VTT & Roleplay Companion Plugins
Using Foundry VTT or SillyTavern directly at your table? Install the official open-source companion plugins alongside MCP:
Foundry VTT Module (v12 / v13): fourgit/avatarsay-foundry-vtt
1-line install in Foundry VTT → Add-on Modules → Install Module → Manifest URL:https://github.com/fourgit/avatarsay-foundry-vtt/releases/latest/download/module.jsonSillyTavern Extension: fourgit/avatarsay-sillytavern
1-line install in SillyTavern → Extensions → Install extension → Git URL:https://github.com/fourgit/avatarsay-sillytavern
Available MCP Tools (10 Tools)
Tool | Auth | Credit Cost | Description |
| Public (none) | 0 | Lists all 8 art styles, 8 English voices (with |
| Public (none) | 0 | Deterministic tabletop RPG / D&D NPC generator with optional |
|
| 0 | Checks current credit balance, quality tier ( |
|
| 0 | Lists recent generated and imported character portraits ( |
|
| 0 | Lists recent 960×960 lip-synced talking MP4 videos ( |
|
| 4 (Std) / 6 (HD) | Enqueues 2 × 1024 px character portraits from a text prompt and returns |
|
| 0 | Imports an existing non-photorealistic fictional character illustration ( |
|
| 2 / 100 chars (min 2) | Synchronous ( |
|
| 0 (1st | Enqueues a watermark-free lip-synced 960×960 MP4 ( |
|
| 0 | Polls |
Built-In MCP Prompts (3 Workflow Templates)
create-rpg-npc— Roll an NPC with SillyTavern V2 + Foundry VTT exports, generate 2 portraits, and render an instant MP3 voice bark or free 5s talking MP4.prep-tavern-encounter— Prep a 3-NPC tavern/dungeon encounter with interconnected hooks, VTT JSON imports, and tabletop MP3 greetings.create-talking-intro— Design a fictional mascot or channel character and animate a short spoken intro clip.
Trust & Safety
Fictional & stylized characters only: Generates original characters from text and accepts non-photorealistic character illustrations (
import_character_portraitwith EXIF camera-tag blocking + AI vision screening). Real human photos, camera captures, face swaps, real public figures, and voice cloning are strictly blocked.Non-blocking async video jobs + instant audio barks:
create_npc_voice_linereturns.mp3audio in<3s, while 3–5 minute video renders (create_talking_video) returnjobIdimmediately so MCP clients never time out.Hashed keys: AvatarSay stores only the SHA-256 hash of
avs_…keys. Revoke keys anytime in Dashboard.
Related Tools
License
MIT
Available Tools
10 toolscreate_npc_voice_lineCreate Fast NPC / Character Voice Line (MP3)AInspect
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_...
Inputs: script (required), voiceId (required), speed, emotion.
create_talking_videoCreate Lip-Synced Talking Character VideoAInspect
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_...
Inputs: voice (required), script (required), assetId (required).
generate_avatarsGenerate Fictional Character AvatarsAInspect
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_...
Inputs: style (required), prompt (required).
get_creditsGet Account Credit BalanceARead-onlyIdempotentInspect
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_...
Inputs: no named parameters.
get_jobGet Generation Job Status & Download URLsARead-onlyIdempotentInspect
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_...
Inputs: jobId (required).
import_character_portraitImport Stylized Fictional Character IllustrationAInspect
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_...
Inputs: confirmFictional (required), label, imageUrl, imageBase64.
list_avatarsList Account Character AvatarsARead-onlyIdempotentInspect
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_...
Inputs: limit.
list_videosList Account Talking VideosARead-onlyIdempotentInspect
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_...
Inputs: limit.
list_voices_and_stylesList Avatar Styles, Voices & Credit PricingARead-onlyIdempotentInspect
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.
Inputs: no named parameters.
roll_rpg_npcRoll Tabletop RPG / D&D NPC + VTT ExportsARead-onlyIdempotentInspect
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.
Inputs: role, seed, style, gender, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool maps to a distinct resource+action: public catalog reads, avatar generation vs. portrait import, NPC voice synthesis, talking video rendering, job polling, and credit/asset listing. The only mild overlap is that both list_voices_and_styles and get_credits surface credit/pricing information, and both generate_avatars and import_character_portrait produce avatars (though via clearly different paths). Descriptions make the boundaries clear enough that an agent should select correctly.
All ten tools follow a consistent snake_case verb_noun pattern: list_voices_and_styles, roll_rpg_npc, get_credits, list_avatars, import_character_portrait, list_videos, generate_avatars, create_npc_voice_line, create_talking_video, get_job. Verbs (list/get/create/generate/import/roll) map predictably to read vs. mutate semantics.
Ten tools is well within the ideal range and each one earns its place: two public onboarding tools, three read tools, three creation/import tools, and a shared job poller. No filler or redundant variants are present.
The core lifecycle is covered end-to-end: discover voices/styles and costs, acquire avatars (generate or import), synthesize voice lines, render talking videos asynchronously, and poll job status with refund handling. Gaps are minor but real — no delete/cleanup for avatars or videos, no job cancellation despite 3–5 minute renders, and no credit purchase tool despite pricing being advertised.
Maintenance
Related MCP Connectors
AI voice generation: text-to-speech and voice cloning from any MCP client.
Generate AI images and videos from any compatible MCP client.
Generate images, video, audio and short films with 140+ AI models from any MCP client.
Generate AI video, images and audio, and browse your history, from any MCP client.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceConnects Claude Desktop to Foundry VTT for AI-powered campaign management, enabling natural language interaction with game data including quest creation, character management, compendium searches, and dice rolling. Provides 20 MCP tools for seamless integration between Claude and your tabletop RPG sessions.85MIT
- AlicenseAqualityDmaintenanceOfficial ElevenLabs MCP server for text-to-speech, voice cloning, audio transcription, and sound generation.24MIT
- AlicenseNot gradedqualityAmaintenanceEnables MCP-compatible clients to generate images and videos, create text-to-speech audio, clone or design voices, and manage output through configurable transports.635 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables MCP-compatible clients to generate images and videos, synthesize speech, and clone or design voices through integrated AI APIs.635 npmMIT