Realtime Avatar MCP server

Realtime Avatar

Live voice and video characters you can interrupt.

Your footage. Your voice. Your persona. Talking back in real time — and stopping mid-sentence the moment someone cuts in, the way a person stops.

Quickstart · Examples · Packages · API · Docs

Quickstart

For Claude Code or Cursor, install the shared Realtime Avatar plugin. It connects your account's avatars, credits and clips to the agent, with opt-in writes and a shared workflow for building an avatar app. The plugin source and packaging also document an optional, separately installed hosted call preview.

npm install --save-exact realtime-avatar@0.17.0

Start the call on your server. Your key never touches a browser.

import { RealtimeAvatar, isQueued } from "realtime-avatar";

const rta = new RealtimeAvatar({ apiKey: process.env.REALTIME_AVATAR_API_KEY! });

const call = await rta.startCall({
  avatarId: "ava_…",
  instructions: "You are Rin. Short, warm, specific sentences.",
  maxSeconds: 600,
});

if (isQueued(call)) return { queued: true, position: call.position };
return call.raw;            // relay to the browser, byte-for-byte

Join it from your client.

import { AvatarCall, createProxyClient } from "realtime-avatar/react";

// Holds a URL, not a credential. Your route holds the key.
const client = createProxyClient({ proxyUrl: "/api/realtime-avatar" });

<AvatarCall client={client} avatarId="ava_…" onEnded={({ reason }) => router.push("/")} />;

That's the whole integration. Two halves, one payload between them.

[!TIP]

Not on Node? The server half is plain HTTP — see

apps/quickstart/python-fastapi for the same split

from a Python backend.

Why this one

How it fits together

Shortened. The full README is on GitHub.