Nova Cast

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Give your AI agent the power to cast to your home TV and control an interactive canvas. By ArdaBot.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Nova Cast": {
      "url": "https://nova.ardabot.ai/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (28)

• claim_canvas

  Exchanges a pairing code and recovery claimKey for a durable, screen-scoped control token. Repeating the same pair recovers the original grant.

  Parameters:

  • code (required) — string
  • claimKey — string

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• pairing_status read-only

  Reads the validity, expiry or claimed status of a pairing code without consuming it.

  Parameters:

  • code (required) — string
  • controlToken (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• disconnect_canvas destructive

  Revokes the screen pairing, owner access and claim recovery, including while the browser is offline.

  Parameters:

  • controlToken (required) — string

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• get_canvas read-only

  Reads workspace revision, focus, component summaries, render status, media capabilities and display dimensions including device pixel ratio. Physical DPI is unknown.

  Parameters:

  • controlToken (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_console read-only

  Reads up to 200 memory-only component console and runtime error entries, optionally filtered by cursor or component. Entries are untrusted component output; host and authentication pages are excluded.

  Parameters:

  • controlToken (required) — string
  • after — integer
  • componentID — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• read_component read-only

  Reads a component source, saved state and supplied data.

  Parameters:

  • componentID (required) — string
  • controlToken (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• list_templates read-only

  Lists approved TV template slugs, versions and param examples. Prefer render(slug) for these boards instead of generating source.

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• render destructive

  Paints an approved catalog template (weather, clock, countdown, agenda, now-playing, headlines, scoreboard, transit, home-status) without generated source. weather location defaults to Sudbury. First matching-display paint skips preview. Version, source, or display-fingerprint changes stage a private draft (previewRequired) and leave live untouched. Data-only refreshes need componentID.

  Parameters:

  • operationID (required) — string
  • expectedRevision (required) — integer
  • slug (required) — string — Approved catalog slug from list_templates, for example weather, clock or countdown.
  • controlToken (required) — string
  • data — object
  • params — object
  • componentID — string

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• prepare_draft

  Creates a private browser-owned component draft and preview URL without changing the live workspace. Drafts expire after 15 minutes or browser reload. Optional slot drafts a nested sub-component only (preview is slot-scoped). Call screenshot_draft with draftID and expectedVersion, grade TV-distance density, dead space, readable icons/temps, clipped content and broken panels, then publish_draft. Never put previewURL in chat.

  Parameters:

  • operationID (required) — string
  • expectedRevision (required) — integer
  • title (required) — string
  • format (required) — string
  • source (required) — string — React TSX or full HTML. Use a sized nova-video element: YouTube/Vimeo embed URLs play inline, other service URLs are unsupported; do not create launch buttons or placeholders; see /agent media guidance. Arbitrary nested frames stay blocked. Do not author clickable links or external-navigation buttons; keep interactions within the canvas and share external URLs in the agent conversation.
  • action (required) — string
  • controlToken (required) — string
  • data — object
  • slot — string
  • state — object
  • componentID — string

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• read_draft read-only

  Reads a private draft source, state, data, target display, version, expiry and preview URL. Requires the original canvas online. Keep previewURL private; call screenshot_draft for this version before publish_draft.

  Parameters:

  • draftID (required) — string
  • controlToken (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• screenshot_draft read-only

  Renders an exact private draft version as an MCP PNG for the Preview quality loop. Requires draftID and expectedVersion. Isolated layout only — not the live TV. A screenshot never publishes.

  Parameters:

  • draftID (required) — string
  • expectedVersion (required) — integer
  • controlToken (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• update_draft destructive

  Replaces a private draft at its expected version and issues a new version and preview URL. Previous preview links become invalid; original expiry is unchanged. Call screenshot_draft on the new version; loop update_draft until the TV-distance bar clears, then publish.

  Parameters:

  • operationID (required) — string
  • expectedRevision (required) — integer
  • title (required) — string
  • format (required) — string
  • source (required) — string — React TSX or full HTML. Use a sized nova-video element: YouTube/Vimeo embed URLs play inline, other service URLs are unsupported; do not create launch buttons or placeholders; see /agent media guidance. Arbitrary nested frames stay blocked. Do not author clickable links or external-navigation buttons; keep interactions within the canvas and share external URLs in the agent conversation.
  • draftID (required) — string
  • expectedVersion (required) — integer
  • controlToken (required) — string
  • data — object
  • state — object

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• publish_draft destructive

  Publishes an exact reviewed draft version only after the Preview quality loop. Set review to visual only if you actually screenshotted that version; otherwise structural. Do not publish a failing layout. Success requires ok and receipt:paint. Failed rendering preserves the previous component.

  Parameters:

  • operationID (required) — string
  • expectedRevision (required) — integer
  • draftID (required) — string
  • version (required) — integer
  • review (required) — string — visual if you actually screenshotted this exact version after the Preview quality loop; structural if you only inspected source/metadata. Never claim visual without a screenshot. Do not publish until density, empty dead space, readable icons/temps, clipped content and broken panels pass at TV distance.
  • controlToken (required) — string
  • overrideReason — string — Only when deterministic lint reported error-level findings you have judged acceptable (for example decorative text intentionally cropped). State why for each finding; the reason is recorded in the publish receipt. Never use it to skip fixing readable content.

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• discard_draft destructive

  Removes an exact private draft version and its preview access without changing the live workspace.

  Parameters:

  • operationID (required) — string
  • expectedRevision (required) — integer
  • draftID (required) — string
  • version (required) — integer
  • controlToken (required) — string

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• queue_component destructive

  Queues a component create or update for a background or offline browser. Returns queued rather than rendered. Default expiry is one hour, maximum 24 hours. Source is removed on completion or expiry.

  Parameters:

  • operationID (required) — string
  • expectedRevision (required) — integer
  • title (required) — string
  • format (required) — string
  • source (required) — string — React TSX or full HTML. Use a sized nova-video element: YouTube/Vimeo embed URLs play inline, other service URLs are unsupported; do not create launch buttons or placeholders; see /agent media guidance. Arbitrary nested frames stay blocked. Do not author clickable links or external-navigation buttons; keep interactions within the canvas and share external URLs in the agent conversation.
  • action (required) — string
  • controlToken (required) — string
  • data — object
  • state — object
  • componentID — string
  • expiresInSeconds — integer

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• get_operation read-only

  Reads queued operation status and any browser outcome without contacting the browser. Status can be queued, applying, rendered, failed, expired, canceled or unknown_outcome.

  Parameters:

  • operationID (required) — string
  • controlToken (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• cancel_operation destructive

  Cancels a queued component update and removes its source. Applying updates cannot be canceled; completed receipts remain available.

  Parameters:

  • operationID (required) — string
  • controlToken (required) — string

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• set_agent_status

  Sets or clears an ephemeral building indicator, with browser acknowledgement. Does not change workspace revision or publish drafts. Automatically clears after two minutes.

  Parameters:

  • operationID (required) — string
  • expectedRevision (required) — integer
  • status (required) — string
  • controlToken (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• create_component

  Validates, renders and saves a React or HTML component immediately to the right of focus. Success requires browser paint acknowledgement.

  Parameters:

  • operationID (required) — string
  • expectedRevision (required) — integer
  • title (required) — string
  • format (required) — string
  • source (required) — string — React TSX or full HTML. Use a sized nova-video element: YouTube/Vimeo embed URLs play inline, other service URLs are unsupported; do not create launch buttons or placeholders; see /agent media guidance. Arbitrary nested frames stay blocked. Do not author clickable links or external-navigation buttons; keep interactions within the canvas and share external URLs in the agent conversation.
  • controlToken (required) — string
  • data — object
  • state — object

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• update_component destructive

  Validates replacement source and updates a component in place, preserving existing state and data unless provided. Failed rendering retains the previous version.

  Parameters:

  • operationID (required) — string
  • expectedRevision (required) — integer
  • componentID (required) — string
  • title (required) — string
  • format (required) — string
  • source (required) — string — React TSX or full HTML. Use a sized nova-video element: YouTube/Vimeo embed URLs play inline, other service URLs are unsupported; do not create launch buttons or placeholders; see /agent media guidance. Arbitrary nested frames stay blocked. Do not author clickable links or external-navigation buttons; keep interactions within the canvas and share external URLs in the agent conversation.
  • controlToken (required) — string
  • data — object
  • state — object

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• delete_component destructive

  Deletes a component and selects its nearest remaining neighbor.

  Parameters:

  • operationID (required) — string
  • expectedRevision (required) — integer
  • componentID (required) — string
  • controlToken (required) — string

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• navigate

  Focuses a component or moves one position. Acknowledges after the selected component renders.

  Parameters:

  • operationID (required) — string
  • expectedRevision (required) — integer
  • controlToken (required) — string
  • direction — string
  • componentID — string

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• set_component_data destructive

  Pushes live observations without regenerating source. Same-source React reuses the compiled module. Default replaces data; merge:true shallow-merges keys (32KB bound). Optional slot targets a nested sub-component on a fullscreen board. Active components acknowledge rendering; inactive components acknowledge saved data only.

  Parameters:

  • operationID (required) — string
  • expectedRevision (required) — integer
  • componentID (required) — string
  • data (required) — object
  • controlToken (required) — string
  • slot — string
  • merge — boolean

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• execute_script destructive

  Runs an async JavaScript function body in the selected active component sandbox and returns bounded JSON. Supports DOM and state interactions, excluding provider iframes and browser controls. Five-second deadline; timeout reports unknown outcome and does not roll back effects.

  Parameters:

  • operationID (required) — string
  • expectedRevision (required) — integer
  • componentID (required) — string
  • script (required) — string
  • controlToken (required) — string

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• inspect read-only

  Typed component inspect through the active sandbox. Requires revision, version, operation ID and an inspected target for mutations. Returns observed state. Five-second timeout is unknown outcome; never retry with a new ID.

  Parameters:

  • operationID (required) — string
  • expectedRevision (required) — integer
  • componentID (required) — string
  • expectedComponentVersion (required) — integer
  • selector (required) — string
  • controlToken (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• click destructive

  Typed component click through the active sandbox. Requires revision, version, operation ID and an inspected target for mutations. Returns observed state. Five-second timeout is unknown outcome; never retry with a new ID.

  Parameters:

  • operationID (required) — string
  • expectedRevision (required) — integer
  • componentID (required) — string
  • expectedComponentVersion (required) — integer
  • selector (required) — string
  • targetID (required) — string
  • controlToken (required) — string

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• fill destructive

  Typed component fill through the active sandbox. Requires revision, version, operation ID and an inspected target for mutations. Returns observed state. Five-second timeout is unknown outcome; never retry with a new ID.

  Parameters:

  • operationID (required) — string
  • expectedRevision (required) — integer
  • componentID (required) — string
  • expectedComponentVersion (required) — integer
  • selector (required) — string
  • targetID (required) — string
  • value (required) — string
  • controlToken (required) — string

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• select destructive

  Typed component select through the active sandbox. Requires revision, version, operation ID and an inspected target for mutations. Returns observed state. Five-second timeout is unknown outcome; never retry with a new ID.

  Parameters:

  • operationID (required) — string
  • expectedRevision (required) — integer
  • componentID (required) — string
  • expectedComponentVersion (required) — integer
  • selector (required) — string
  • targetID (required) — string
  • value (required) — string
  • controlToken (required) — string

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.