Skip to main content
Glama

AvatarSay MCP Server (v1.2.0)

CI AvatarSay MCP Server MCP server – quality and maintenance score on Glama License: MIT

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: roll_rpg_npc and list_voices_and_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.

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

  • SillyTavern 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

list_voices_and_styles

Public (none)

0

Lists all 8 art styles, 8 English voices (with .mp3 sample URLs), VTT/SillyTavern plugins, free-clip rules, voice-bark pricing, and one-time credit packs.

roll_rpg_npc

Public (none)

0

Deterministic tabletop RPG / D&D NPC generator with optional seed, style, gender, ancestry, role, and exportFormat filters. Returns full NPC sheet, <=75-char greeting (fits free 5s video!), SillyTavern Card V2 JSON, Foundry VTT Actor JSON, and copy-pasteable nextToolCalls.

get_credits

Bearer avs_…

0

Checks current credit balance, quality tier (standard vs hd), firstFreeVideoAvailable & firstFreeVideoStatus, and remaining capacity across avatars, MP3 voice barks, and video seconds.

list_avatars

Bearer avs_…

0

Lists recent generated and imported character portraits (ast_…) with 24-hour signed URLs.

list_videos

Bearer avs_…

0

Lists recent 960×960 lip-synced talking MP4 videos (ast_…) with 24-hour signed download URLs.

generate_avatars

Bearer avs_…

4 (Std) / 6 (HD)

Enqueues 2 × 1024 px character portraits from a text prompt and returns jobId immediately (~5–10s render).

import_character_portrait

Bearer avs_…

0

Imports an existing non-photorealistic fictional character illustration (PNG / JPEG / WebP, 256–4096 px, <=5 MB, confirmFictional: true) via imageUrl or imageBase64 so you can animate VTT tokens or Midjourney art with create_talking_video. Real human photos and camera EXIF are blocked.

create_npc_voice_line

Bearer avs_…

2 / 100 chars (min 2)

Synchronous (<3s) tabletop NPC .mp3 audio bark (1–500 chars, optional speed 0.8–1.2 and emotion). Stores MP3 and returns a 24-hour signed download URL immediately (auto-refunds on error).

create_talking_video

Bearer avs_…

0 (1st <=5s clip), then 12 / sec (min 60)

Enqueues a watermark-free lip-synced 960×960 MP4 (5–30s) from any generated or imported ast_… portrait and returns jobId immediately without blocking. First <=5s (<=75-char) clip is 0 credits on eligible unpaid accounts!

get_job

Bearer avs_…

0

Polls queued / running / succeeded / failed status for image or video jobs and returns 24-hour signed download URLs (auto-refunds failed renders).

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_portrait with 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_line returns .mp3 audio in <3s, while 3–5 minute video renders (create_talking_video) return jobId immediately so MCP clients never time out.

  • Hashed keys: AvatarSay stores only the SHA-256 hash of avs_… keys. Revoke keys anytime in Dashboard.

License

MIT

Available Tools

10 tools
create_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 BalanceA
Read-onlyIdempotent
Inspect

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 URLsA
Read-onlyIdempotent
Inspect

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 AvatarsA
Read-onlyIdempotent
Inspect

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 VideosA
Read-onlyIdempotent
Inspect

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 PricingA
Read-onlyIdempotent
Inspect

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 ExportsA
Read-onlyIdempotent
Inspect

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

    A4.3/5.0

    Scored across 10 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers