Public npm launch live. Latest release v1.0.2.

CueScope MCP

Read-first production intelligence for workflows compatible with vMix.

CueScope helps producers, technical directors, and operators use AI assistants to inspect live-production state, explain inputs and titles, diagnose routing risks, review saved presets and scripts, and generate automation plans before anything changes. Available now on npm as @greenhouselabs/cuescope-mcp@1.0.2.

CueScope in Review Mode reading vMix server status and state summary inside an MCP client.
CueScope reading live vMix state in Review Mode before any control tools are enabled.

Default

Review Mode

Package

@greenhouselabs/cuescope-mcp@1.0.2

License

Source-available

Status

Available on npm

Available on npm

Public npm launch is live

CueScope is published on npm and the source-available GitHub repository is public for review, setup guidance, and issue tracking. Install the package globally or connect it directly from an MCP client with npx.

npm install -g @greenhouselabs/cuescope-mcp

Package

@greenhouselabs/cuescope-mcp@1.0.2

Published on npm for MCP client setup.

Status

Public launch live

CueScope is available now from the public npm registry.

GitHub repository

Public

The source-available repository is public for review, setup guidance, and issue tracking.

Release

v1.0.2

Latest release includes richer live inspection and preset metadata review.

v1.0.2 update

Sharper inspection before operators make changes

The latest release focuses on production confidence: more useful live input inspection, richer saved preset metadata, and more targeted review of title, trigger, and script references.

Live-first input inspection

Prioritizes the running show so producers, technical directors, and operators can inspect real inputs before leaning on saved preset assumptions.

Saved GT/title countdown metadata parsing

Surfaces saved graphics and title countdown metadata so review notes can include timing behavior operators need to verify.

Title data-source binding detection

Detects title field bindings to data sources, helping teams trace where on-air text may be populated from before showtime.

Targeted trigger/script reference summaries

Summarizes nearby trigger and script references for the requested input so automation risks are easier to review before control is enabled.

What it does

Understand the show before changing the show

CueScope connects AI assistants to live show state and curated production knowledge so operators can ask better questions before a rehearsal, stream, recording, or client show.

Inspect Live Show State

Read live show state, inputs, active and preview paths, overlays, tally, title fields, and production relationships before making recommendations.

Explain Inputs And Titles

Translate inputs, title fields, countdown metadata, and data-source bindings into operator language with clear assumptions.

Diagnose Audio And Routing

Review buses, mutes, solo state, vMix Call patterns, route choices, output readiness, and mix-minus risks.

Review Saved .vmix Presets

Inspect saved presets for scripts, triggers, audio evidence, redacted metadata, and differences from the running show.

Generate Reviewable Plans

Produce script reviews, targeted trigger summaries, and ordered API plans using actual references without executing them in Review Mode.

Safety model

Review first. Control only by explicit opt-in.

CueScope starts in Review Mode, exposing 18 review-only tools for inspection, diagnosis, validation, and planning. Safer control tools require VMIX_CONTROL_MODE=true, and high-impact actions such as scripts, batch commands, recording, streaming, presets, output routing, destructive input changes, show-building, and replay recording require VMIX_HIGH_IMPACT=true as a second gate.

Default

Review Mode

Exposes 18 review-only tools to read state, explain setup, diagnose risks, validate scripts, and produce checklists or automation plans. It does not mutate vMix.

Explicit opt-in

Control Mode

Unlocks gated control tools only when the operator sets VMIX_CONTROL_MODE=true in the MCP client environment.

Second gate

High-Impact Control

Requires VMIX_CONTROL_MODE=true and VMIX_HIGH_IMPACT=true for scripts, batch commands, recording, streaming, presets, output routing, destructive input changes, show-building, and replay recording.

Available on npm

Install CueScope

CueScope installs as an MCP package from npm as @greenhouselabs/cuescope-mcp. Version 1.0.2 is live. Start with Review Mode, then enable control only after the read-only setup is working.

Package

@greenhouselabs/cuescope-mcp

Binary

cuescope-mcp

Version

1.0.2

Runtime

Node.js 20+

Default Mode

Review Mode

Global install

npm install -g @greenhouselabs/cuescope-mcp

MCP client setups can also run the published package with npx, as shown in the examples.

Control Mode Safety

Control Mode is not a first-run step. Only enable VMIX_CONTROL_MODE=true after Review Mode is working. High-Impact Control requires both VMIX_CONTROL_MODE=true and VMIX_HIGH_IMPACT=true.

Requirements

First-run setup starts in Review Mode.

vMix Web Controller: vMix running, Web Controller enabled, default port 8088.

API reachability: MCP host can reach the vMix Web Controller API on the configured host and port.

MCP client: Claude Desktop, Claude Code, Cursor, or Codex.

First-run boundary: Trusted local/network use only; leave VMIX_CONTROL_MODE unset.

vMix Web Controller is unauthenticated. Do not expose it to the public internet.

Claude Desktop / JSON

Use this shape for MCP clients that read a server configuration file.

npm live
{
  "mcpServers": {
    "cuescope": {
      "command": "npx",
      "args": ["-y", "@greenhouselabs/cuescope-mcp"],
      "env": {
        "VMIX_HOST": "localhost",
        "VMIX_HTTP_PORT": "8088",
        "VMIX_TCP_PORT": "8099"
      }
    }
  }
}

First-Run Smoke Test

Start with a read-only prompt.

Use CueScope. Read vmix://server/status and vmix://state/summary. Do not control vMix yet.

server reports Review Mode

controlMode is false

highImpactMode is false

18 review-only tools are available by default

vmix://state/summary returns current vMix state

no live-control tool is called

Example workflows

Useful before rehearsal, before go-live, and after something feels off

CueScope is strongest when a user asks for inspection, explanation, diagnosis, or a reviewable plan. It can help a team turn a messy vMix setup into a checklist the operator can trust.

Pre-show review

Ask CueScope to explain the current preset, identify active and preview paths, summarize graphics and audio state, and call out anything worth checking before rehearsal.

Audio and mix-minus diagnosis

Review buses, mute state, solo state, vMix Call routing, caller returns, and feedback risks before a remote guest hears the wrong mix.

Output readiness

Separate what vMix state can prove from what still needs operator verification: stream destination, recording path, audio feed, external output, and downstream hardware.

Script review

Generate or validate VB.NET scripts with stable input references, syntax checks, loop-safety warnings, assumptions, and rehearsal notes.

Saved preset audit

Review a saved .vmix file for scripts, triggers, audio evidence, and drift from the running show without writing to the preset.

Automation planning

Produce ordered vMix API plans and operator checklists before enabling any direct control surface.

Built for

Production people who need clarity under pressure

CueScope is for operators and builders who already know vMix is powerful, but want an AI assistant that can read the show, respect the control boundary, and produce reviewable next steps.

Live-production operators
Technical directors
vMix power users
Streaming teams
Broadcast engineers
AI-assisted production builders

Launch status

Setup details are live, npm install is available now, and the v1.0.2 release is ready for review.

Published on npm as @greenhouselabs/cuescope-mcp@1.0.2.

Global install command: npm install -g @greenhouselabs/cuescope-mcp.

The source-available GitHub repository is public for review, setup guidance, and issue tracking.

GitHub release v1.0.2 is available for launch review.

Review Mode is the recommended first-run experience with 18 review-only tools.

The server has 135 known tools, with control and high-impact tools hidden behind explicit gates.

Source-available

The source is available for review, learning, verification, debugging, and private internal modification under the CueScope Source-Available License.

Not open source

Redistribution, public forks, competing products, hosted managed offerings, and broader reuse require written permission from Greenhouse Ventures LLC.

Independent integration

CueScope is independent software for workflows compatible with vMix. It is not affiliated with, endorsed by, or sponsored by vMix or StudioCoast Pty Ltd. vMix is a trademark of its respective owner.

FAQ

Practical answers for launch

Is CueScope open source?

No. CueScope is source-available under the CueScope Source-Available License. Greenhouse Ventures LLC is the legal owner and licensor, and Greenhouse Labs is the public brand.

Does it control vMix?

Not by default. Review Mode is the default and does not mutate vMix. Direct control requires VMIX_CONTROL_MODE=true, and high-impact actions require VMIX_HIGH_IMPACT=true as a second gate.

Does it expose secrets?

CueScope is designed to redact sensitive values from preset and log-derived output, including stream keys, tokens, passwords, and vMix Call secrets. Operators should still avoid exposing vMix Web Controller to the public internet and should review any shared logs or presets carefully.

Is this affiliated with vMix?

No. CueScope is independent software from Greenhouse Labs and Greenhouse Ventures LLC. It is not affiliated with, endorsed by, or sponsored by vMix or StudioCoast Pty Ltd.

Greenhouse Labs Updates

Get product launches, project updates, release notes, demos, and studio writing from across Greenhouse Labs.