Realtime Avatar
Read your avatars, credits and session bills so a coding agent can build avatar apps
- Pricing
- Freemium
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 0.40.0
- Listing updated
- 3 days ago
About Realtime Avatar
Realtime Avatar is a freemium MCP server for design and media. It runs locally on your machine and is started by your AI client.
The author's reasoning is blunt: an agent cannot guess an avatar id, so docs alone produce code against characters that do not exist. This server lets the agent read your real account first, then write against what is there.
Read tools are on by default. Write tools, including avatar creation, clip library edits and start_call, need REALTIME_AVATAR_ALLOW_WRITES=1, and start_call bills per second and refuses live keys. It runs from npx over stdio with an API key from workspace settings. Plans use credits: a sandbox of 480 free credits once per account, a Starter plan at 7,200 credits a month, Developer at 36,000 and a Studio tier above that, with overage around $0.085 to $0.095 a minute.
Install
Run in a terminal
claude mcp add realtime-avatar --env REALTIME_AVATAR_API_KEY='<REALTIME_AVATAR_API_KEY>' -- npx -y realtime-avatar-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"realtime-avatar": {
"command": "npx",
"args": [
"-y",
"realtime-avatar-mcp"
],
"env": {
"REALTIME_AVATAR_API_KEY": "<REALTIME_AVATAR_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"realtime-avatar": {
"command": "npx",
"args": [
"-y",
"realtime-avatar-mcp"
],
"env": {
"REALTIME_AVATAR_API_KEY": "<REALTIME_AVATAR_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"realtime-avatar": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"realtime-avatar-mcp"
],
"env": {
"REALTIME_AVATAR_API_KEY": "<REALTIME_AVATAR_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"realtime-avatar": {
"command": "npx",
"args": [
"-y",
"realtime-avatar-mcp"
],
"env": {
"REALTIME_AVATAR_API_KEY": "<REALTIME_AVATAR_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"realtime-avatar": {
"command": "npx",
"args": [
"-y",
"realtime-avatar-mcp"
],
"env": {
"REALTIME_AVATAR_API_KEY": "<REALTIME_AVATAR_API_KEY>"
}
}
}
}Configuration
REALTIME_AVATAR_API_KEYRealtime Avatar API key (tic_test_ or tic_live_). A free sandbox key: https://realtimeavatar.ai/signupRequiredREALTIME_AVATAR_ALLOW_WRITESSet to 1 to enable write tools (avatar creation, clip library, start_call). start_call bills per second and refuses tic_live_ keys.
Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- name
- description
What it does
- Read-only by default
- Lists avatars and checks balance without cost.
- Write opt-in
- Enable creation tools with an environment flag.
- Create from media
- Make avatars from an image or video.
- Clip library
- Manage idle clips and loops.
- Session history
- List past sessions and bills.
- TypeScript SDK
- Docs show building a Next.js starter with a real avatar id.
Good for
- Pick a real avatar id before coding
- Check credits before starting a call
- Create an avatar from a photo
- Review session bills
Pricing
Freemium
480 free credits once; paid plans from 7,200 credits/month
Prices change. Check realtimeavatar.ai before you buy.
Realtime Avatar FAQ
Can the agent spend money by default?
No, writes and start_call are off until enabled.
How is it installed?
npx realtime-avatar-mcp with an API key.
Is there a free tier?
480 free credits once per account.
How much does extra time cost?
About $0.085 to $0.095 a minute on paid tiers.
Is Realtime Avatar free?
Realtime Avatar has a free plan, with paid plans for more usage or features.
How do I add Realtime Avatar to Claude Code?
Run this command in your terminal: claude mcp add realtime-avatar --env REALTIME_AVATAR_API_KEY='<REALTIME_AVATAR_API_KEY>' -- npx -y realtime-avatar-mcp
What are the best alternatives to Realtime Avatar?
The closest alternatives to Realtime Avatar are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.
Alternatives to Realtime Avatar

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media