@laplace.live/persona-mcp

An MCP server that lets AI assistants — Claude Desktop, Claude Code, Cursor, Codex, and any other MCP client — drive a running LAPLACE Persona: switch scenes, load and place models, trigger expressions and motions, run automations, and look at the stage to check the result.

Setup

1. In Persona, open Settings → Plugin API, turn on Enable API, and create an API key.
2. Add the server to your MCP client with that key as PERSONA_TOKEN:

{
  "mcpServers": {
    "persona": {
      "command": "npx",
      "args": ["-y", "@laplace.live/persona-mcp"],
      "env": { "PERSONA_TOKEN": "sk-lp-v1-…" }
    }
  }
}

Claude Code: claude mcp add persona -e PERSONA_TOKEN=sk-lp-v1-… -- npx -y @laplace.live/persona-mcp.

Persona on another machine (with its LAN option on): set PERSONA_ADDRESS to host, host:port, or a full ws:// URL. Persona does not have to be running when the client starts; the server connects on the first tool call.

Tools

• get_state, capture_stage — what is on stage, and a screenshot of it
• activate_scene, create_scene, rename_scene, delete_scene
• list_models, add_model, describe_model, remove_item, set_visible, set_placement, reset_placement
• set_text — change what a text object reads, or show live text such as captions without saving it
• set_expression, play_motion, stop_motion
• list_automations, run_automation, trigger_hotkey
• call_api — any method of the plugin API

capture_stage, stop_motion and set_text need a Persona new enough to support them — each says so when yours does not; every other tool works with any Persona that serves the plugin API.