sceneview-mcp 4.0.0 → 4.0.2

package/README.md

@@ -44,13 +44,35 @@ After subscribing, you'll receive a `sv_live_…` API key. Set it via the `SCENE
 
 ## Quick start (free tier)
 
-**One command -- no install required:**
+You have two ways to use SceneView MCP — pick whichever fits your client:
+
+### Option A — stdio via `npx` (Claude Desktop, Claude Code, Cursor, Windsurf)
 
 ```bash
-npx sceneview-mcp@beta
+npx sceneview-mcp
 ```
 
-On startup you'll see a `[sceneview-mcp] v4.0.0-beta.1 — LITE (free tools only)` banner on stderr. Set `SCENEVIEW_API_KEY` to flip into `HOSTED` mode.
+On startup you'll see a `[sceneview-mcp] v4.0.1 — LITE (free tools only)` banner on stderr. Set `SCENEVIEW_API_KEY` to flip into `HOSTED` mode.
+
+### Option B — hosted HTTP MCP URL (ChatGPT, Claude Desktop "Remote MCP", Cursor URL, anything HTTP)
+
+No install, no `npx`, no config files — just point your client at:
+
+```
+https://sceneview-mcp.mcp-tools-lab.workers.dev/mcp/public
+```
+
+- Anonymous, no API key required
+- 26 free tools fully accessible
+- 35 Pro tools return a `/pricing` upgrade prompt
+- Rate limit: 60 requests / hour per IP
+
+For **Pro tier with a Bearer token** (full quota, all 35 Pro tools):
+
+```
+https://sceneview-mcp.mcp-tools-lab.workers.dev/mcp
+Authorization: Bearer sv_live_...
+```
 
 > **Anonymous telemetry** is enabled on the free tier (MCP client name/version and tool names — no personal data, no prompt content). Opt out with `SCENEVIEW_TELEMETRY=0`. See [PRIVACY.md](./PRIVACY.md#telemetry-free-tier) for the full payload shape.
 
@@ -107,7 +129,7 @@ Same JSON config as above. The server communicates via **stdio** using the stand
 | `get_sample` | Returns a complete, compilable code sample for any of 33 scenarios (Kotlin or Swift) |
 | `list_samples` | Browse all samples, filter by tag (`ar`, `3d`, `ios`, `animation`, `geometry`, ...) |
 | `validate_code` | Checks generated code against 15+ rules before presenting it to the user |
-| `get_node_reference` | Full API reference for any of 26+ node types -- exact signatures, defaults, examples |
+| `get_node_reference` | Full API reference for any of 35+ node types -- exact signatures, defaults, examples |
 | `list_platforms` | List all supported platforms with their status, renderer, and framework |
 | `get_setup` | Gradle + manifest setup for Android 3D or AR projects |
 | `get_ios_setup` | SPM dependency, Info.plist, and SwiftUI integration for iOS/macOS/visionOS |
@@ -168,7 +190,7 @@ The tool is read-only, never writes to disk, and gracefully handles missing dire
 
 | Resource URI | What it provides |
 |---|---|
-| `sceneview://api` | Complete SceneView 3.6.0 API reference (the full `llms.txt`) |
+| `sceneview://api` | Complete SceneView 4.0.0 API reference (the full `llms.txt`) |
 | `sceneview://known-issues` | Live open issues from GitHub (cached 10 min) |
 
 ---
@@ -208,10 +230,10 @@ The assistant calls `render_3d_preview` and returns an interactive link to a bro
 - Have no knowledge of SceneView's iOS/Swift API at all
 
 **With** this MCP server, AI assistants:
-- Always use the current SceneView 3.6.0 API surface
+- Always use the current SceneView 4.0.0 API surface
 - Generate correct **Compose-native** 3D/AR code for Android
 - Generate correct **SwiftUI-native** code for iOS/macOS/visionOS
-- Know about all 26+ node types and their exact parameters
+- Know about all 35+ node types and their exact parameters
 - Validate code against 15+ rules before presenting it
 - Provide working, tested sample code for 33 scenarios
 

package/dist/analyze-project.js

@@ -23,7 +23,7 @@ import { promises as fs } from "node:fs";
 import path from "node:path";
 // ─── Constants ───────────────────────────────────────────────────────────────
 /** The latest SceneView release known to this build of the MCP. */
-export const LATEST_SCENEVIEW_VERSION = "4.0.0-rc.1";
+export const LATEST_SCENEVIEW_VERSION = "4.0.0";
 /** Hard cap on the number of source files inspected per call. */
 export const MAX_FILES_SCANNED = 30;
 /** Hard cap on total bytes read across all source files per call (500 KB). */

package/dist/debug-issue.js

@@ -292,7 +292,7 @@ fun DebugModelViewer() {
         title: "Build / Gradle Errors",
         guide: `## Debugging: Build Errors
 
-### "Cannot resolve io.github.sceneview:sceneview:4.0.0-rc.1"
+### "Cannot resolve io.github.sceneview:sceneview:4.0.0"
 
 1. Check repositories in \`settings.gradle.kts\`:
    \`\`\`kotlin
@@ -335,7 +335,7 @@ SceneView bundles Filament. If you also depend on Filament directly:
 \`\`\`kotlin
 // Remove direct Filament dependency — SceneView includes it
 // implementation("com.google.android.filament:filament-android:1.x.x") // REMOVE
-implementation("io.github.sceneview:sceneview:4.0.0-rc.1") // This includes Filament
+implementation("io.github.sceneview:sceneview:4.0.0") // This includes Filament
 \`\`\`
 
 ### "Cannot find Filament material"

package/dist/extra-guides.js

@@ -419,7 +419,7 @@ Browser → WebGL2 → Filament.js (WASM) → GPU
 ### Using sceneview.js (npm or local)
 \`\`\`html
 <!-- Option 1: npm CDN -->
-<script src="https://cdn.jsdelivr.net/npm/sceneview-web@4.0.0-rc.1/sceneview.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/sceneview-web@4.0.0/sceneview.js"></script>
 
 <!-- Option 2: local hosting (recommended for production) -->
 <!-- Copy js/filament/ directory to your server for faster WASM loading -->

package/dist/generate-scene.js

@@ -4,7 +4,7 @@
  * Generates a complete SceneView{} or ARSceneView{} composable from a text description.
  * Maps common objects/concepts to SceneView node types and builds compilable code.
  *
- * All generated code targets SceneView v4.0.0-rc.1 API and is verified against llms.txt.
+ * All generated code targets SceneView v4.0.0 API and is verified against llms.txt.
  */
 const OBJECT_MAPPINGS = [
     // Furniture
@@ -245,7 +245,7 @@ export function generateScene(description) {
     }
     // Build the code
     const isAR = parsed.isAR;
-    dependencies.push(isAR ? "io.github.sceneview:arsceneview:4.0.0-rc.1" : "io.github.sceneview:sceneview:4.0.0-rc.1");
+    dependencies.push(isAR ? "io.github.sceneview:arsceneview:4.0.0" : "io.github.sceneview:sceneview:4.0.0");
     // Build model instance declarations
     const modelElements = elements.filter((e) => e.type === "model");
     const uniqueModels = new Map();