Primeta MCP reference

primeta_connect

Activate a session and load your persona. Must be called before any other tool. Returns the persona's personality prompt, conversation URL, and available emotion tags.

Arguments

• connection_name — optional, a label for this session (e.g. project directory name)

primeta_send

Speak a message through the avatar. Appears in the web chat UI and is spoken aloud with phoneme-driven lip sync. Write in your persona's voice.

Arguments

• text — required, plain text with optional emotion tags at sentence starts

Emotion Tags

Place at the start of a sentence to control spoken tone:

[happy] Tests are green — all 42 specs pass. [curious] Want me to push the branch?

Available: happy, sad, angry, surprised, relaxed, neutral, excited, curious, confident, friendly, mysterious

primeta_get_hook_config

Get the hook configuration for real-time avatar reactions to coding events. Returns a ready-to-merge JSON config for the user's settings file. Call this when the user asks to set up hooks.

How it works

The config adds HTTP hooks that POST coding events (tool success, failure, stop) to Primeta. The avatar reacts with animations — celebration on success, facepalm on errors, idle when done. Reactions are customizable per persona in settings.

primeta_get_status

Check connection status, active persona, and conversation URL.

primeta_list_personas

List personas available to the current user. Returns name, slug, and ID for each.

primeta_set_persona

Switch the active persona. Call primeta_list_personas first to see available options.

Arguments

• persona_id — required, integer from the persona list

primeta_disconnect

Disconnect a session and free the connection slot. Pass all_others to clean up stale sessions while keeping the current one.

Arguments

• session_id — optional, specific session ID, bridge name, or all_others