Primeta Claude Plugin

Connect Claude Code to Primeta — chat with 3D avatar companions through a web UI while Claude has full project context.

Install

Add to your project's .mcp.json:

{
  "mcpServers": {
    "primeta": {
      "command": "npx",
      "args": ["@primeta.ai/claude-plugin"],
      "env": {
        "PRIMETA_SERVER_URL": "https://primeta.ai",
        "PRIMETA_API_KEY": "your-api-key"
      }
    }
  }
}

Get your API key from primeta.ai/settings (under Bridge Setup).

Usage

Start Claude Code with the channel flag to enable real-time messaging:

claude --dangerously-load-development-channels server:primeta

Then open primeta.ai and start chatting with your avatar.

Tools

| Tool | Description | |------|-------------| | primeta_send | Send a message — pass message_id to reply to a channel message, omit for unprompted sends | | primeta_fetch_persona | Load the active persona's personality | | primeta_set_emotion | Change the avatar's expression (joy, thinking, sad, etc.) | | primeta_get_status | Check bridge connection and active persona | | primeta_set_persona | Switch the active persona by ID | | primeta_list_personas | List available personas |

How It Works

Primeta Bridge is an MCP server that connects Claude Code to the Primeta web app via ActionCable WebSocket. Messages from the chat UI arrive as channel notifications; Claude replies using the tools above.

The bridge uses the experimental claude/channel capability for real-time bidirectional messaging.

Requirements

• Node.js 18+
• Claude Code 2.1.80+
• A Primeta account

Configuration

| Environment Variable | Required | Description | |---------------------|----------|-------------| | PRIMETA_SERVER_URL | Yes | Primeta server URL (default: https://primeta.ai) | | PRIMETA_API_KEY | Yes | Bridge API key from your Primeta settings | | PRIMETA_BRIDGE_NAME | No | Name for this bridge instance (defaults to project directory name) |

License

MIT