Realtime Avatar

realtime-avatar-mcp

npm では realtime-avatar-mcp として公開されています。アプリにインストールせず、npx で実行してください。

Realtime Avatar 用の MCP サーバーです。AGENTS.md には API の内容が記載されています。このサーバーを使えば、ID やデータ形式を推測するのではなく、アバター、残高、請求内容を確認できます。

{
  "mcpServers": {
    "realtime-avatar": {
      "command": "npx",
      "args": ["-y", "realtime-avatar-mcp"],
      "env": { "REALTIME_AVATAR_API_KEY": "tic_test_…" }
    }
  }
}

書き込みツールとその料金を含む全ページはこちらです： https://realtimeavatar.ai/docs/mcp。先に API キーが必要です。sandbox key は無料で、カードも不要です。

このリポジトリで作業する場合は、npm run build を実行し、command に node を指定して、 args: ["/abs/path/to/realtime-avatar-sdk/libs/mcp/dist/bin.js"] を設定してください。

ツール

ツール
list_avatars	startCall に渡す ID と、ライブで使用できるアバターをすべて表示します
get_avatar	1 つのアバターの詳細をすべて表示します
credit_balance	残高と、進行中の通話で予約されているクレジットを表示します
list_sessions	項目別の請求内容を表示します。各セッションの実行日時、長さ、料金を確認できます
list_clips	アバターのクリップライブラリを表示します。すべてのクリップ、ステータス、リビジョン、レストポーズを確認できます

REALTIME_AVATAR_ALLOW_WRITES=1 を設定した場合：

ツール		請求あり？
set_loop	新しい説明に基づき、アバターの待機ループを変更します	いいえ
set_clip_library	アバターのクリップ一式を JSON で指定します。プラットフォームがレンダリングします	いいえ
upload_asset	このマシンのディスク上にあるファイルをアップロードし、公開 URL を取得します	いいえ
create_remote_asset	すでにインターネット上にあるファイルを登録します。ローカルコピーは不要です	いいえ
create_avatar_from_image	1 枚の静止画からアバターを作成します。ループは自動生成されます	いいえ
create_avatar_from_video	非推奨です。 新規呼び出しは受け付けません（422）。画像ツールを使用してください	いいえ
start_call	統合を検証するライブセッションを作成します	はい、秒単位

支出はオプトインで、二重の制限があります

上記の 5 つのツールは読み取り専用で、それぞれ readOnlyHint を備えています。そのため、ホストは認識する必要のある名前ではなく、このアノテーションに基づいて制限できます。本番用キーを指定しても、このサーバーは開いたままのダッシュボードと同程度の危険性しかありません。

REALTIME_AVATAR_ALLOW_WRITES=1 を設定すると、書き込みツールが有効になります。クレジットが必要なのは start_call だけで、tic_live_ キーでは実行を拒否します。テストキーに対して書き込みを有効にしたオペレーターが、後から本番用キーに差し替えたときに、請求されて初めて気づくような事態を防ぐためです。2 つの独立した制限を設けています。どちらか 1 つだけでは、たった 1 つのミスで制限がなくなってしまうからです。

書き込みを有効にする前に、次の 2 点を理解してください。

• upload_asset はローカルディスクを読み取ります。 エージェントが指定する絶対パスを、サーバーを実行しているマシン上で開きます。相対パスは、ホストがサーバーを起動したディレクトリを基準に解決するのではなく、拒否されます。
• クリップ宣言では、省略したものが削除されます。 set_clip_library には完全なセットを渡します。セットに含まれないものは配信されなくなります。計画では、保持・キュー登録・削除されるクリップが報告されます。source.motionPrompt または source.assetId を宣言してください。メディアはプラットフォームがホストして準備します。アバターに保存されたソースが暗黙の待機状態となるため、宣言する必要はありません。したがって、ID primary は予約されています。

MCP サーバーが必要な理由

ドキュメントを読むエージェントでも、推測は避けられません。ava_… の ID は推測できません。また、ここで最も時間を浪費する失敗は、型シグネチャからは分かりません。接続ペイロードの形式が変わるとブラウザクライアントに拒否されます。通話時の 429 はエラーではなくキューを示します。待機ループはライブラリ内のクリップではなくアバターのソースであるため、宣言を変更しても変わりません。

list_avatars は、実際に使用可能なアバターを示します。サーバーの instructions には、中継のルールと秒単位の課金モデルが記載されています。これはエージェントが自力では導き出せないコンテキストを、実行直前のタイミングで提供します。