# Realtime Avatar

> Realtime Avatar is a freemium MCP server for design and media. Read your avatars, credits and session bills so a coding agent can build avatar apps. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://realtimeavatar.ai/docs/mcp
- **Repository:** https://github.com/theinfluencecompany/realtime-avatar-sdk/tree/HEAD/libs/mcp
- **MCP Registry name:** io.github.theinfluencecompany/realtime-avatar
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add realtime-avatar --env REALTIME_AVATAR_API_KEY='<REALTIME_AVATAR_API_KEY>' -- npx -y realtime-avatar-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "realtime-avatar": {
      "command": "npx",
      "args": [
        "-y",
        "realtime-avatar-mcp"
      ],
      "env": {
        "REALTIME_AVATAR_API_KEY": "<REALTIME_AVATAR_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "realtime-avatar": {
      "command": "npx",
      "args": [
        "-y",
        "realtime-avatar-mcp"
      ],
      "env": {
        "REALTIME_AVATAR_API_KEY": "<REALTIME_AVATAR_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "realtime-avatar": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "realtime-avatar-mcp"
      ],
      "env": {
        "REALTIME_AVATAR_API_KEY": "<REALTIME_AVATAR_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "realtime-avatar": {
      "command": "npx",
      "args": [
        "-y",
        "realtime-avatar-mcp"
      ],
      "env": {
        "REALTIME_AVATAR_API_KEY": "<REALTIME_AVATAR_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "realtime-avatar": {
      "command": "npx",
      "args": [
        "-y",
        "realtime-avatar-mcp"
      ],
      "env": {
        "REALTIME_AVATAR_API_KEY": "<REALTIME_AVATAR_API_KEY>"
      }
    }
  }
}
```

## Tools

- `name`: description

## 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

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/realtime-avatar
