sceneview-mcp 4.0.0 → 4.0.2

package/dist/guides.js

@@ -6,16 +6,16 @@
 // ─── Platform Roadmap ─────────────────────────────────────────────────────────
 export const PLATFORM_ROADMAP = `# SceneView Multi-Platform Roadmap
 
-## Current Status (v4.0.0-rc.1)
+## Current Status (v4.0.0)
 
 | Platform | Status | Artifact | Renderer |
 |----------|--------|----------|----------|
-| **Android (Compose)** | Stable | \`io.github.sceneview:sceneview:4.0.0-rc.1\` | Filament |
-| **Android (AR)** | Stable | \`io.github.sceneview:arsceneview:4.0.0-rc.1\` | Filament + ARCore |
-| **iOS (SwiftUI)** | Alpha | SceneViewSwift SPM \`from: "4.0.0-rc.1"\` | RealityKit + ARKit |
+| **Android (Compose)** | Stable | \`io.github.sceneview:sceneview:4.0.0\` | Filament |
+| **Android (AR)** | Stable | \`io.github.sceneview:arsceneview:4.0.0\` | Filament + ARCore |
+| **iOS (SwiftUI)** | Alpha | SceneViewSwift SPM \`from: "4.0.0"\` | RealityKit + ARKit |
 | **macOS (SwiftUI)** | Alpha | SceneViewSwift SPM (in Package.swift) | RealityKit |
 | **visionOS (SwiftUI)** | Alpha | SceneViewSwift SPM (in Package.swift) | RealityKit |
-| **KMP Core** | Stable | \`io.github.sceneview:sceneview-core:4.0.0-rc.1\` | N/A (shared logic) |
+| **KMP Core** | Stable | \`io.github.sceneview:sceneview-core:4.0.0\` | N/A (shared logic) |
 
 ## Architecture: Native Renderers per Platform
 
@@ -54,7 +54,7 @@ Shared Kotlin Multiplatform module providing:
 
 ## Upcoming
 
-- **v4.0.0-rc.1**: SceneViewSwift stabilization, API parity with Android core nodes, KMP core XCFramework consumption
+- **v4.0.0**: SceneViewSwift stabilization, API parity with Android core nodes, KMP core XCFramework consumption
 - **v4.0.0**: Android XR, visionOS spatial computing, cross-framework bridges (Flutter, React Native)
 
 ## How to Stay Updated
@@ -338,7 +338,7 @@ export const AR_SETUP_GUIDE = `# SceneView AR — Complete Setup Guide (Android
 ## 1. SPM Dependency
 
 \`\`\`swift
-.package(url: "https://github.com/sceneview/sceneview", from: "4.0.0-rc.1")
+.package(url: "https://github.com/sceneview/sceneview", from: "4.0.0")
 \`\`\`
 
 ## 2. Info.plist — Camera Permission
@@ -423,7 +423,7 @@ ARSceneView(
 \`\`\`kotlin
 // build.gradle.kts (app module)
 dependencies {
-    implementation("io.github.sceneview:arsceneview:4.0.0-rc.1")
+    implementation("io.github.sceneview:arsceneview:4.0.0")
     // arsceneview includes sceneview transitively — no need to add both
 }
 \`\`\`

package/dist/index.js

@@ -9,7 +9,7 @@
  * two MCP resources (`sceneview://api`, `sceneview://known-issues`) and
  * the pro-tier access / billing checks.
  *
- * IMPORTANT: the runtime behaviour must stay identical to v4.0.0-rc.1 for
+ * IMPORTANT: the runtime behaviour must stay identical to v4.0.0 for
  * existing npm consumers. Do not reorder checks, do not change content
  * strings, do not touch disclaimers.
  */
@@ -27,7 +27,7 @@ import { API_DOCS, TOOL_DEFINITIONS, dispatchTool, } from "./tools/index.js";
 // Claude Desktop surfaces this in the server's "Logs" panel. The banner
 // tells the user which mode they're in (hosted vs free) and where to
 // upgrade, without blocking the transport handshake.
-const PACKAGE_VERSION = "4.0.0-rc.5";
+const PACKAGE_VERSION = "4.0.2";
 function logStartupBanner() {
     if (process.env.SCENEVIEW_MCP_QUIET === "1")
         return;
@@ -57,7 +57,7 @@ server.setRequestHandler(ListResourcesRequestSchema, async () => ({
         {
             uri: "sceneview://api",
             name: "SceneView API Reference",
-            description: "Complete SceneView 4.0.0-rc.1 API — SceneView, ARSceneView, SceneScope DSL, ARSceneScope DSL, node types, resource loading, camera, gestures, math types, threading rules, and common patterns. Read this before writing any SceneView code.",
+            description: "Complete SceneView 4.0.0 API — SceneView, ARSceneView, SceneScope DSL, ARSceneScope DSL, node types, resource loading, camera, gestures, math types, threading rules, and common patterns. Read this before writing any SceneView code.",
             mimeType: "text/markdown",
         },
         {

package/dist/migration.js

@@ -8,8 +8,8 @@ SceneView 3.0 is a full rewrite from Android Views to **Jetpack Compose**. Nearl
 
 | 2.x | 3.0 |
 |-----|-----|
-| \`io.github.sceneview:sceneview:2.x.x\` | \`io.github.sceneview:sceneview:4.0.0-rc.1\` |
-| \`io.github.sceneview:arsceneview:2.x.x\` | \`io.github.sceneview:arsceneview:4.0.0-rc.1\` |
+| \`io.github.sceneview:sceneview:2.x.x\` | \`io.github.sceneview:sceneview:4.0.0\` |
+| \`io.github.sceneview:arsceneview:2.x.x\` | \`io.github.sceneview:arsceneview:4.0.0\` |
 
 ---
 

package/dist/platform-setup.js

@@ -12,7 +12,7 @@ const ANDROID_3D = `## SceneView Android — 3D Setup
 \`\`\`kotlin
 // build.gradle.kts (app module)
 dependencies {
-    implementation("io.github.sceneview:sceneview:4.0.0-rc.1")
+    implementation("io.github.sceneview:sceneview:4.0.0")
 }
 \`\`\`
 
@@ -87,7 +87,7 @@ const ANDROID_AR = `## SceneView Android — AR Setup
 \`\`\`kotlin
 // build.gradle.kts (app module)
 dependencies {
-    implementation("io.github.sceneview:arsceneview:4.0.0-rc.1")
+    implementation("io.github.sceneview:arsceneview:4.0.0")
     // arsceneview includes sceneview transitively
 }
 \`\`\`
@@ -177,7 +177,7 @@ In Xcode: **File > Add Package Dependencies** > paste:
 \`\`\`
 https://github.com/sceneview/sceneview
 \`\`\`
-Set version rule to **"from: 4.0.0-rc.1"**.
+Set version rule to **"from: 4.0.0"**.
 
 Or in Package.swift:
 \`\`\`swift
@@ -188,7 +188,7 @@ let package = Package(
     name: "MyApp",
     platforms: [.iOS(.v18), .macOS(.v15), .visionOS(.v1)],
     dependencies: [
-        .package(url: "https://github.com/sceneview/sceneview", from: "4.0.0-rc.1")
+        .package(url: "https://github.com/sceneview/sceneview", from: "4.0.0")
     ],
     targets: [
         .executableTarget(
@@ -273,7 +273,7 @@ const IOS_AR = `## SceneViewSwift — iOS AR Setup
 ### 1. SPM Dependency
 
 \`\`\`swift
-.package(url: "https://github.com/sceneview/sceneview", from: "4.0.0-rc.1")
+.package(url: "https://github.com/sceneview/sceneview", from: "4.0.0")
 \`\`\`
 
 ### 2. Info.plist — Camera Permission (Required)
@@ -417,7 +417,7 @@ SceneView Flutter uses **PlatformView** to embed native SceneView (Android: Fila
 \`\`\`yaml
 # pubspec.yaml
 dependencies:
-  sceneview_flutter: ^4.0.0-rc.1
+  sceneview_flutter: ^4.0.0
 \`\`\`
 
 ### 2. Android Setup
@@ -476,7 +476,7 @@ const FLUTTER_AR = `## SceneView Flutter — AR Setup
 
 \`\`\`yaml
 dependencies:
-  sceneview_flutter: ^4.0.0-rc.1
+  sceneview_flutter: ^4.0.0
 \`\`\`
 
 ### 2. Android Manifest
@@ -632,7 +632,7 @@ plugins {
 
 dependencies {
     implementation(compose.desktop.currentOs)
-    implementation("io.github.sceneview:sceneview-desktop:4.0.0-rc.1") // when published
+    implementation("io.github.sceneview:sceneview-desktop:4.0.0") // when published
 }
 \`\`\`
 
@@ -683,7 +683,7 @@ SceneView on Android TV uses the same Filament renderer as mobile Android, with
 
 \`\`\`kotlin
 dependencies {
-    implementation("io.github.sceneview:sceneview:4.0.0-rc.1")
+    implementation("io.github.sceneview:sceneview:4.0.0")
     implementation("androidx.leanback:leanback:1.0.0")
     implementation("androidx.tv:tv-foundation:1.0.0-alpha10")
 }
@@ -748,14 +748,14 @@ const SETUPS = {
     android: {
         name: "Android (Jetpack Compose)",
         renderer: "Filament (OpenGL ES / Vulkan)",
-        status: "Stable (v4.0.0-rc.1)",
+        status: "Stable (v4.0.0)",
         guide3d: ANDROID_3D,
         guideAr: ANDROID_AR,
     },
     ios: {
         name: "iOS / macOS / visionOS (SwiftUI)",
         renderer: "RealityKit (Metal)",
-        status: "Alpha (v4.0.0-rc.1)",
+        status: "Alpha (v4.0.0)",
         guide3d: IOS_3D,
         guideAr: IOS_AR,
     },

package/dist/samples.js

@@ -4,8 +4,8 @@ export const SAMPLES = {
         title: "3D Model Viewer",
         description: "Full-screen 3D scene with a GLB model, HDR environment, orbit camera, and animation controls",
         tags: ["3d", "model", "environment", "camera", "animation"],
-        dependency: "io.github.sceneview:sceneview:4.0.0-rc.1",
-        prompt: "Create an Android Compose screen that loads a GLB model and displays it with HDR lighting, orbit camera, and animation playback. Use SceneView `io.github.sceneview:sceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:sceneview:4.0.0",
+        prompt: "Create an Android Compose screen that loads a GLB model and displays it with HDR lighting, orbit camera, and animation playback. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
         code: `@Composable
 fun ModelViewerScreen() {
     val engine = rememberEngine()
@@ -38,8 +38,8 @@ fun ModelViewerScreen() {
         title: "AR Tap-to-Place Model Viewer",
         description: "AR scene with plane detection. Tap a surface to place a 3D model with pinch-to-scale and drag-to-rotate gestures.",
         tags: ["ar", "model", "anchor", "plane-detection", "placement", "gestures"],
-        dependency: "io.github.sceneview:arsceneview:4.0.0-rc.1",
-        prompt: "Create an AR screen that detects surfaces and lets the user tap to place a GLB model. Support pinch-to-scale and drag-to-rotate. Use SceneView `io.github.sceneview:arsceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:arsceneview:4.0.0",
+        prompt: "Create an AR screen that detects surfaces and lets the user tap to place a GLB model. Support pinch-to-scale and drag-to-rotate. Use SceneView `io.github.sceneview:arsceneview:4.0.0`.",
         code: `@Composable
 fun ARModelViewerScreen() {
     val engine = rememberEngine()
@@ -83,8 +83,8 @@ fun ARModelViewerScreen() {
         title: "AR Augmented Image",
         description: "Detects reference images in the camera feed and overlays 3D models or video above them.",
         tags: ["ar", "model", "image-tracking"],
-        dependency: "io.github.sceneview:arsceneview:4.0.0-rc.1",
-        prompt: "Create an AR screen that detects a printed reference image and places a 3D model above it. Use SceneView `io.github.sceneview:arsceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:arsceneview:4.0.0",
+        prompt: "Create an AR screen that detects a printed reference image and places a 3D model above it. Use SceneView `io.github.sceneview:arsceneview:4.0.0`.",
         code: `@Composable
 fun AugmentedImageScreen() {
     val engine = rememberEngine()
@@ -125,8 +125,8 @@ fun AugmentedImageScreen() {
         title: "AR Cloud Anchor",
         description: "Host and resolve persistent cross-device anchors using ARCore Cloud Anchors.",
         tags: ["ar", "anchor", "cloud-anchor"],
-        dependency: "io.github.sceneview:arsceneview:4.0.0-rc.1",
-        prompt: "Create an AR screen that can host a cloud anchor (saving its ID) and resolve it later on another device. Use SceneView `io.github.sceneview:arsceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:arsceneview:4.0.0",
+        prompt: "Create an AR screen that can host a cloud anchor (saving its ID) and resolve it later on another device. Use SceneView `io.github.sceneview:arsceneview:4.0.0`.",
         code: `@Composable
 fun CloudAnchorScreen() {
     val engine = rememberEngine()
@@ -156,8 +156,8 @@ fun CloudAnchorScreen() {
         title: "AR Point Cloud",
         description: "Visualizes ARCore feature points as 3D spheres with confidence-based filtering.",
         tags: ["ar", "point-cloud"],
-        dependency: "io.github.sceneview:arsceneview:4.0.0-rc.1",
-        prompt: "Create an AR screen that visualizes ARCore feature points as small 3D spheres, filtered by confidence. Use SceneView `io.github.sceneview:arsceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:arsceneview:4.0.0",
+        prompt: "Create an AR screen that visualizes ARCore feature points as small 3D spheres, filtered by confidence. Use SceneView `io.github.sceneview:arsceneview:4.0.0`.",
         code: `@Composable
 fun PointCloudScreen() {
     val engine = rememberEngine()
@@ -188,8 +188,8 @@ fun PointCloudScreen() {
         title: "AR Face Mesh",
         description: "AR face tracking with AugmentedFaceNode — applies a textured mesh overlay to detected faces using the front camera.",
         tags: ["ar", "face-tracking", "model"],
-        dependency: "io.github.sceneview:arsceneview:4.0.0-rc.1",
-        prompt: "Create an AR screen that uses the front camera to detect faces and overlay a 3D mesh on them. Use SceneView `io.github.sceneview:arsceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:arsceneview:4.0.0",
+        prompt: "Create an AR screen that uses the front camera to detect faces and overlay a 3D mesh on them. Use SceneView `io.github.sceneview:arsceneview:4.0.0`.",
         code: `@Composable
 fun ARFaceMeshScreen() {
     val engine = rememberEngine()
@@ -232,8 +232,8 @@ fun ARFaceMeshScreen() {
         title: "glTF Camera",
         description: "Extracts and uses camera definitions embedded in a glTF file for cinematic viewpoints.",
         tags: ["3d", "model", "camera"],
-        dependency: "io.github.sceneview:sceneview:4.0.0-rc.1",
-        prompt: "Create a 3D scene that loads a GLB file containing embedded camera definitions, then uses those cameras for cinematic viewpoints. Use SceneView `io.github.sceneview:sceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:sceneview:4.0.0",
+        prompt: "Create a 3D scene that loads a GLB file containing embedded camera definitions, then uses those cameras for cinematic viewpoints. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
         code: `@Composable
 fun GltfCameraScreen() {
     val engine = rememberEngine()
@@ -262,8 +262,8 @@ fun GltfCameraScreen() {
         title: "Camera Manipulator",
         description: "Orbit, pan, and zoom camera with customizable sensitivity and bounds.",
         tags: ["3d", "camera", "gestures"],
-        dependency: "io.github.sceneview:sceneview:4.0.0-rc.1",
-        prompt: "Create a 3D scene with a fully configurable orbit camera — drag to rotate, two-finger pan, pinch to zoom. Use SceneView `io.github.sceneview:sceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:sceneview:4.0.0",
+        prompt: "Create a 3D scene with a fully configurable orbit camera — drag to rotate, two-finger pan, pinch to zoom. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
         code: `@Composable
 fun CameraManipulatorScreen() {
     val engine = rememberEngine()
@@ -293,8 +293,8 @@ fun CameraManipulatorScreen() {
         title: "Camera Animation",
         description: "Animated camera flythrough around a 3D model — smooth orbit using LaunchedEffect and trigonometric interpolation.",
         tags: ["3d", "camera", "animation", "model"],
-        dependency: "io.github.sceneview:sceneview:4.0.0-rc.1",
-        prompt: "Create a 3D scene with a camera that automatically orbits around a model in a smooth circle. Include a play/pause button. Use SceneView `io.github.sceneview:sceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:sceneview:4.0.0",
+        prompt: "Create a 3D scene with a camera that automatically orbits around a model in a smooth circle. Include a play/pause button. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
         code: `@Composable
 fun CameraAnimationScreen() {
     val engine = rememberEngine()
@@ -354,8 +354,8 @@ fun CameraAnimationScreen() {
         title: "Autopilot Demo",
         description: "Autonomous driving HUD with animated car, road geometry, and real-time telemetry overlay.",
         tags: ["3d", "model", "animation", "geometry"],
-        dependency: "io.github.sceneview:sceneview:4.0.0-rc.1",
-        prompt: "Create an autopilot-style visualization with a 3D car on a road and a HUD overlay showing speed, distance, and status. Use SceneView `io.github.sceneview:sceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:sceneview:4.0.0",
+        prompt: "Create an autopilot-style visualization with a 3D car on a road and a HUD overlay showing speed, distance, and status. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
         code: `@Composable
 fun AutopilotScreen() {
     val engine = rememberEngine()
@@ -423,8 +423,8 @@ fun AutopilotScreen() {
         title: "Physics Simulation",
         description: "Animated physics simulation with spheres falling under gravity and bouncing off a floor, using onFrame for per-frame updates.",
         tags: ["3d", "physics", "geometry", "animation"],
-        dependency: "io.github.sceneview:sceneview:4.0.0-rc.1",
-        prompt: "Create a 3D scene with spheres that fall under gravity and bounce on a floor using per-frame animation. Use SceneView `io.github.sceneview:sceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:sceneview:4.0.0",
+        prompt: "Create a 3D scene with spheres that fall under gravity and bounce on a floor using per-frame animation. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
         code: `@Composable
 fun PhysicsDemoScreen() {
     val engine = rememberEngine()
@@ -516,8 +516,8 @@ fun PhysicsDemoScreen() {
         title: "Dynamic Sky & Lighting",
         description: "Time-of-day sun cycle with animated LightNode direction, intensity, and color to simulate sunrise through sunset.",
         tags: ["3d", "sky", "environment", "animation", "lighting"],
-        dependency: "io.github.sceneview:sceneview:4.0.0-rc.1",
-        prompt: "Create a 3D scene with a time-of-day sun that moves from sunrise through noon to sunset, with animated light color and intensity. Use SceneView `io.github.sceneview:sceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:sceneview:4.0.0",
+        prompt: "Create a 3D scene with a time-of-day sun that moves from sunrise through noon to sunset, with animated light color and intensity. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
         code: `@Composable
 fun DynamicSkyScreen() {
     val engine = rememberEngine()
@@ -600,8 +600,8 @@ fun DynamicSkyScreen() {
         title: "Line & Path",
         description: "Animated 3D line art with sine waves and Lissajous curves using PathNode and LineNode, with parameter sliders.",
         tags: ["3d", "lines", "geometry", "animation"],
-        dependency: "io.github.sceneview:sceneview:4.0.0-rc.1",
-        prompt: "Create a 3D scene that draws animated parametric curves (sine wave, Lissajous) using PathNode with amplitude and frequency sliders. Use SceneView `io.github.sceneview:sceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:sceneview:4.0.0",
+        prompt: "Create a 3D scene that draws animated parametric curves (sine wave, Lissajous) using PathNode with amplitude and frequency sliders. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
         code: `@Composable
 fun LinePathScreen() {
     val engine = rememberEngine()
@@ -677,8 +677,8 @@ fun LinePathScreen() {
         title: "Text Labels",
         description: "Camera-facing 3D text labels using TextNode — floating labels above geometry spheres representing planets.",
         tags: ["3d", "text", "geometry"],
-        dependency: "io.github.sceneview:sceneview:4.0.0-rc.1",
-        prompt: "Create a 3D scene with floating text labels above colored spheres representing planets. Use TextNode for the labels. Use SceneView `io.github.sceneview:sceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:sceneview:4.0.0",
+        prompt: "Create a 3D scene with floating text labels above colored spheres representing planets. Use TextNode for the labels. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
         code: `@Composable
 fun TextLabelsScreen() {
     val engine = rememberEngine()
@@ -735,8 +735,8 @@ fun TextLabelsScreen() {
         title: "Reflection Probe",
         description: "Zone-based IBL overrides with material picker (Chrome, Gold, Copper, Rough) and probe toggle.",
         tags: ["3d", "reflection", "environment", "model"],
-        dependency: "io.github.sceneview:sceneview:4.0.0-rc.1",
-        prompt: "Create a 3D scene with a metallic sphere and a ReflectionProbeNode that overrides the IBL. Add a material picker to switch between Chrome, Gold, Copper, and Rough. Use SceneView `io.github.sceneview:sceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:sceneview:4.0.0",
+        prompt: "Create a 3D scene with a metallic sphere and a ReflectionProbeNode that overrides the IBL. Add a material picker to switch between Chrome, Gold, Copper, and Rough. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
         code: `@Composable
 fun ReflectionProbeScreen() {
     val engine = rememberEngine()
@@ -771,8 +771,8 @@ fun ReflectionProbeScreen() {
         title: "Post-Processing",
         description: "Real-time post-processing effects: bloom, vignette, tone mapping, FXAA, and SSAO controls.",
         tags: ["3d", "post-processing", "environment"],
-        dependency: "io.github.sceneview:sceneview:4.0.0-rc.1",
-        prompt: "Create a 3D scene with interactive post-processing controls for bloom, vignette, tone mapping, FXAA, and SSAO. Use SceneView `io.github.sceneview:sceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:sceneview:4.0.0",
+        prompt: "Create a 3D scene with interactive post-processing controls for bloom, vignette, tone mapping, FXAA, and SSAO. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
         code: `@Composable
 fun PostProcessingScreen() {
     val engine = rememberEngine()
@@ -799,8 +799,8 @@ fun PostProcessingScreen() {
         title: "Video Texture",
         description: "Video playback on a 3D plane using VideoNode with MediaPlayer — supports looping, chroma-key, and auto-sizing.",
         tags: ["3d", "video", "model"],
-        dependency: "io.github.sceneview:sceneview:4.0.0-rc.1",
-        prompt: "Create a 3D scene with a video playing on a floating 3D plane. Include play/pause controls and chroma-key support. Use SceneView `io.github.sceneview:sceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:sceneview:4.0.0",
+        prompt: "Create a 3D scene with a video playing on a floating 3D plane. Include play/pause controls and chroma-key support. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
         code: `@Composable
 fun VideoTextureScreen() {
     val context = LocalContext.current
@@ -849,8 +849,8 @@ fun VideoTextureScreen() {
         title: "Multi-Model Scene",
         description: "Scene with multiple 3D models loaded independently, positioned and scaled to create a complete environment.",
         tags: ["3d", "model", "multi-model", "environment"],
-        dependency: "io.github.sceneview:sceneview:4.0.0-rc.1",
-        prompt: "Create a 3D scene that loads multiple GLB models (a car, a building, and trees) and positions them to form a street scene. Use SceneView `io.github.sceneview:sceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:sceneview:4.0.0",
+        prompt: "Create a 3D scene that loads multiple GLB models (a car, a building, and trees) and positions them to form a street scene. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
         code: `@Composable
 fun MultiModelScreen() {
     val engine = rememberEngine()
@@ -915,8 +915,8 @@ fun MultiModelScreen() {
         title: "Gesture Interaction",
         description: "Full gesture handling — tap to select, double-tap to scale, long-press for info, pinch-to-scale, drag-to-move on editable nodes.",
         tags: ["3d", "gestures", "model"],
-        dependency: "io.github.sceneview:sceneview:4.0.0-rc.1",
-        prompt: "Create a 3D scene with a model that responds to tap (select), double-tap (scale up), long-press (show info), and supports pinch-to-scale and drag-to-move. Use SceneView `io.github.sceneview:sceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:sceneview:4.0.0",
+        prompt: "Create a 3D scene with a model that responds to tap (select), double-tap (scale up), long-press (show info), and supports pinch-to-scale and drag-to-move. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
         code: `@Composable
 fun GestureInteractionScreen() {
     val engine = rememberEngine()
@@ -979,8 +979,8 @@ fun GestureInteractionScreen() {
         title: "Environment & Lighting",
         description: "Complete lighting setup — HDR environment (IBL + skybox), main directional light, point light, and spot light with LightNode.",
         tags: ["3d", "environment", "lighting", "model"],
-        dependency: "io.github.sceneview:sceneview:4.0.0-rc.1",
-        prompt: "Create a 3D scene with full HDR environment lighting (IBL + skybox), a directional sun light, a red point light, and a blue spot light. Use SceneView `io.github.sceneview:sceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:sceneview:4.0.0",
+        prompt: "Create a 3D scene with full HDR environment lighting (IBL + skybox), a directional sun light, a red point light, and a blue spot light. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
         code: `@Composable
 fun EnvironmentLightingScreen() {
     val engine = rememberEngine()
@@ -1048,8 +1048,8 @@ fun EnvironmentLightingScreen() {
         title: "Procedural Geometry",
         description: "Procedural shapes — CubeNode, SphereNode, CylinderNode, PlaneNode — with PBR materials (metallic, roughness, color).",
         tags: ["3d", "geometry", "model"],
-        dependency: "io.github.sceneview:sceneview:4.0.0-rc.1",
-        prompt: "Create a 3D scene showing procedural geometry shapes (cube, sphere, cylinder, plane) with different PBR materials. No model files needed. Use SceneView `io.github.sceneview:sceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:sceneview:4.0.0",
+        prompt: "Create a 3D scene showing procedural geometry shapes (cube, sphere, cylinder, plane) with different PBR materials. No model files needed. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
         code: `@Composable
 fun ProceduralGeometryScreen() {
     val engine = rememberEngine()
@@ -1128,8 +1128,8 @@ fun ProceduralGeometryScreen() {
         title: "Compose UI in 3D",
         description: "Embed interactive Jetpack Compose UI (Cards, Buttons, Text) inside 3D space using ViewNode.",
         tags: ["3d", "compose-ui", "text"],
-        dependency: "io.github.sceneview:sceneview:4.0.0-rc.1",
-        prompt: "Create a 3D scene with interactive Compose UI elements (Card with text and a button) floating in 3D space using ViewNode. Use SceneView `io.github.sceneview:sceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:sceneview:4.0.0",
+        prompt: "Create a 3D scene with interactive Compose UI elements (Card with text and a button) floating in 3D space using ViewNode. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
         code: `@Composable
 fun ComposeUI3DScreen() {
     val engine = rememberEngine()
@@ -1178,8 +1178,8 @@ fun ComposeUI3DScreen() {
         title: "Node Hierarchy",
         description: "Parent-child node relationships — a spinning solar system with planet groups orbiting a central sun.",
         tags: ["3d", "hierarchy", "geometry", "animation"],
-        dependency: "io.github.sceneview:sceneview:4.0.0-rc.1",
-        prompt: "Create a 3D solar system where planets orbit a sun using parent-child node hierarchies. Each planet group rotates independently. Use SceneView `io.github.sceneview:sceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:sceneview:4.0.0",
+        prompt: "Create a 3D solar system where planets orbit a sun using parent-child node hierarchies. Each planet group rotates independently. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
         code: `@Composable
 fun NodeHierarchyScreen() {
     val engine = rememberEngine()
@@ -1259,7 +1259,7 @@ fun NodeHierarchyScreen() {
         title: "iOS 3D Model Viewer",
         description: "SwiftUI 3D scene with a USDZ model, IBL environment, orbit camera, and animation playback.",
         tags: ["3d", "model", "environment", "camera", "animation", "ios", "swift"],
-        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0-rc.1\"",
+        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0\"",
         spmDependency: "https://github.com/sceneview/sceneview",
         prompt: "Create a SwiftUI screen that loads a USDZ model and displays it with IBL lighting, orbit camera, and animation playback. Use SceneViewSwift.",
         language: "swift",
@@ -1298,7 +1298,7 @@ struct ModelViewerScreen: View {
         title: "iOS AR Tap-to-Place Model Viewer",
         description: "AR scene with plane detection. Tap a surface to place a 3D model using ARKit + RealityKit.",
         tags: ["ar", "model", "anchor", "plane-detection", "placement", "ios", "swift"],
-        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0-rc.1\"",
+        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0\"",
         spmDependency: "https://github.com/sceneview/sceneview",
         prompt: "Create an iOS AR screen that detects surfaces and lets the user tap to place a USDZ model. Use SceneViewSwift.",
         language: "swift",
@@ -1338,7 +1338,7 @@ struct ARModelViewerScreen: View {
         title: "iOS AR Augmented Image",
         description: "Detects reference images in the camera feed and overlays 3D content above them using ARKit.",
         tags: ["ar", "model", "image-tracking", "ios", "swift"],
-        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0-rc.1\"",
+        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0\"",
         spmDependency: "https://github.com/sceneview/sceneview",
         prompt: "Create an iOS AR screen that detects a printed reference image and places a 3D model above it. Use SceneViewSwift.",
         language: "swift",
@@ -1376,7 +1376,7 @@ struct AugmentedImageScreen: View {
         title: "iOS Procedural Geometry",
         description: "Procedural geometry shapes — cube, sphere, cylinder, cone, and plane — with PBR materials.",
         tags: ["3d", "geometry", "ios", "swift"],
-        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0-rc.1\"",
+        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0\"",
         spmDependency: "https://github.com/sceneview/sceneview",
         prompt: "Create a SwiftUI scene showing procedural geometry shapes (cube, sphere, cylinder, cone, plane) with different materials. Use SceneViewSwift.",
         language: "swift",
@@ -1430,7 +1430,7 @@ struct GeometryShapesScreen: View {
         title: "iOS Lighting",
         description: "Directional, point, and spot lights with configurable intensity, color, and shadows.",
         tags: ["3d", "lighting", "environment", "ios", "swift"],
-        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0-rc.1\"",
+        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0\"",
         spmDependency: "https://github.com/sceneview/sceneview",
         prompt: "Create a SwiftUI 3D scene with directional, point, and spot lights illuminating geometry. Use SceneViewSwift.",
         language: "swift",
@@ -1494,7 +1494,7 @@ struct LightingScreen: View {
         title: "iOS Physics Demo",
         description: "Interactive physics simulation with bouncing spheres, gravity, and configurable restitution.",
         tags: ["3d", "physics", "geometry", "ios", "swift"],
-        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0-rc.1\"",
+        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0\"",
         spmDependency: "https://github.com/sceneview/sceneview",
         prompt: "Create a SwiftUI 3D scene where tapping spawns coloured spheres that fall under gravity and bounce off a floor. Use SceneViewSwift.",
         language: "swift",
@@ -1558,7 +1558,7 @@ struct PhysicsDemoScreen: View {
         title: "iOS 3D Text Labels",
         description: "Camera-facing 3D text labels using TextNode and BillboardNode for always-facing-camera behavior.",
         tags: ["3d", "text", "geometry", "ios", "swift"],
-        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0-rc.1\"",
+        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0\"",
         spmDependency: "https://github.com/sceneview/sceneview",
         prompt: "Create a SwiftUI 3D scene with floating text labels that always face the camera, showing planet names. Use SceneViewSwift.",
         language: "swift",
@@ -1606,7 +1606,7 @@ struct TextLabelsScreen: View {
         title: "iOS Video on 3D Surface",
         description: "Video playback on a 3D plane using VideoNode with play/pause controls.",
         tags: ["3d", "video", "ios", "swift"],
-        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0-rc.1\"",
+        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0\"",
         spmDependency: "https://github.com/sceneview/sceneview",
         prompt: "Create a SwiftUI 3D scene with a video playing on a floating 3D plane. Include play/pause controls. Use SceneViewSwift.",
         language: "swift",
@@ -1677,8 +1677,8 @@ struct VideoPlayerScreen: View {
         title: "Image Node",
         description: "Display images on 3D planes using ImageNode — from assets, resources, or Bitmaps.",
         tags: ["3d", "image", "geometry"],
-        dependency: "io.github.sceneview:sceneview:4.0.0-rc.1",
-        prompt: "Create a 3D scene with images displayed on floating planes using ImageNode. Show examples from file, resource, and Bitmap. Use SceneView `io.github.sceneview:sceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:sceneview:4.0.0",
+        prompt: "Create a 3D scene with images displayed on floating planes using ImageNode. Show examples from file, resource, and Bitmap. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
         code: `@Composable
 fun ImageNodeScreen() {
     val engine = rememberEngine()
@@ -1736,8 +1736,8 @@ fun ImageNodeScreen() {
         title: "Billboard Sprite",
         description: "Always-facing-camera sprites using BillboardNode — useful for markers, icons, and info overlays in 3D space.",
         tags: ["3d", "billboard", "image"],
-        dependency: "io.github.sceneview:sceneview:4.0.0-rc.1",
-        prompt: "Create a 3D scene with billboard sprites that always face the camera, useful for markers and info overlays. Use SceneView `io.github.sceneview:sceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:sceneview:4.0.0",
+        prompt: "Create a 3D scene with billboard sprites that always face the camera, useful for markers and info overlays. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
         code: `@Composable
 fun BillboardSpriteScreen() {
     val engine = rememberEngine()
@@ -1801,8 +1801,8 @@ fun BillboardSpriteScreen() {
         title: "Animation State Machine",
         description: "Reactive animation driven by Compose state — switch between Idle, Walk, and Run animations on a character model.",
         tags: ["3d", "model", "animation"],
-        dependency: "io.github.sceneview:sceneview:4.0.0-rc.1",
-        prompt: "Create a 3D scene with a character model that switches between Idle, Walk, and Run animations based on button clicks. Use animationName for state-driven animation. Use SceneView `io.github.sceneview:sceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:sceneview:4.0.0",
+        prompt: "Create a 3D scene with a character model that switches between Idle, Walk, and Run animations based on button clicks. Use animationName for state-driven animation. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
         code: `@Composable
 fun AnimationStateScreen() {
     val engine = rememberEngine()
@@ -1865,8 +1865,8 @@ fun AnimationStateScreen() {
         title: "Spring Animation",
         description: "Smooth spring-based node animations using Compose animateFloatAsState with spring spec for natural motion.",
         tags: ["3d", "animation", "spring", "geometry"],
-        dependency: "io.github.sceneview:sceneview:4.0.0-rc.1",
-        prompt: "Create a 3D scene with geometry nodes that animate position using spring physics via Compose's animateFloatAsState. Tap to toggle positions with springy motion. Use SceneView `io.github.sceneview:sceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:sceneview:4.0.0",
+        prompt: "Create a 3D scene with geometry nodes that animate position using spring physics via Compose's animateFloatAsState. Tap to toggle positions with springy motion. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
         code: `@Composable
 fun SpringAnimationScreen() {
     val engine = rememberEngine()
@@ -1958,8 +1958,8 @@ fun SpringAnimationScreen() {
         title: "AR Surface Cursor",
         description: "AR scene with a center-screen reticle using HitResultNode that follows the detected surface.",
         tags: ["ar", "cursor", "plane-detection", "placement"],
-        dependency: "io.github.sceneview:arsceneview:4.0.0-rc.1",
-        prompt: "Create an AR screen with a surface cursor (reticle) in the center of the screen that follows detected surfaces, using HitResultNode. Tap to place a model at the cursor position. Use SceneView `io.github.sceneview:arsceneview:4.0.0-rc.1`.",
+        dependency: "io.github.sceneview:arsceneview:4.0.0",
+        prompt: "Create an AR screen with a surface cursor (reticle) in the center of the screen that follows detected surfaces, using HitResultNode. Tap to place a model at the cursor position. Use SceneView `io.github.sceneview:arsceneview:4.0.0`.",
         code: `@Composable
 fun ARSurfaceCursorScreen() {
     val engine = rememberEngine()

package/dist/telemetry.js

@@ -43,7 +43,7 @@ function isEnabled() {
 // Falls back to "unknown" so payloads stay well-formed even if
 // something goes wrong.
 function getMcpVersion() {
-    return process.env.SCENEVIEW_MCP_VERSION ?? "4.0.0-rc.3";
+    return process.env.SCENEVIEW_MCP_VERSION ?? "4.0.0";
 }
 // Fire-and-forget POST of a single payload to the individual event endpoint.
 // Used as fallback when batch delivery fails.

package/dist/tiers.js

@@ -3,6 +3,7 @@
 // Defines free vs pro tool access for SceneView MCP.
 // ─── Free tools (17) ─────────────────────────────────────────────────────────
 const FREE_TOOLS = [
+    "get_started",
     "list_samples",
     "get_sample",
     "get_setup",

package/dist/tools/definitions.js

@@ -11,6 +11,33 @@ import { SAMPLE_IDS, SAMPLES } from "../samples.js";
 import { PLATFORM_IDS } from "../platform-setup.js";
 import { DEBUG_CATEGORIES } from "../debug-issue.js";
 export const TOOL_DEFINITIONS = [
+    {
+        // Activation tool — designed to be called immediately after init by the
+        // host AI. Intentionally listed FIRST so it's the first tool the model
+        // notices when scanning the MCP server's tool list. Returns a short
+        // overview + 3 concrete prompt suggestions the user can run, plus the
+        // canonical install snippet for whichever platform they target.
+        //
+        // Empirical motivation: 30-day telemetry shows ~55% of MCP inits never
+        // produce a tool call. Most of those clients (cursor-vscode, codex,
+        // claude-desktop, claude.ai) install but never trigger anything because
+        // the existing tool descriptions are passive lookups ("Returns ..."), not
+        // actions. This tool gives the host AI a clear hook to surface SceneView
+        // capabilities right after install.
+        name: "get_started",
+        description: "Run this FIRST when SceneView MCP is freshly installed, or whenever the user asks 'what can SceneView do', 'how do I start with SceneView', 'show me an AR example', or any open-ended SceneView question. Returns a one-page overview with 3 concrete prompts the user can try immediately, the install snippet for their platform, and links to the playground. Always call this before any other SceneView tool when the conversation has no prior SceneView context.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                platform: {
+                    type: "string",
+                    enum: ["android", "ios", "web", "any"],
+                    description: 'Target platform — "android" (Jetpack Compose + Filament), "ios" (SwiftUI + RealityKit), "web" (Filament.js + WebXR), or "any" for an unopinionated overview. Defaults to "any" if unsure.',
+                },
+            },
+            required: [],
+        },
+    },
     {
         name: "get_sample",
         description: "Returns a complete, compilable Kotlin sample for a given SceneView scenario. Use this to get a working starting point before customising. Call `list_samples` first if you are unsure which scenario fits.",