Skip to content
MCP server

Realtime Avatar

Read your avatars, credits and session bills so a coding agent can build avatar apps

Runs locallyStatus and history
Install
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-mcp

Add 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/signupRequired
  • REALTIME_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

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media