# Verse (npm · @ctruhtech/verse-mcp)

Turn 3D files into shareable, embeddable Verse links from any AI assistant.

- Trust score: 65/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- npm · `@ctruhtech/verse-mcp`: 65/100 (this document), [markdown](https://verifymcp.io/servers/dev-vinayagastya-verse-mcp/ctruhtech-verse-mcp.md), [page](https://verifymcp.io/servers/dev-vinayagastya-verse-mcp/ctruhtech-verse-mcp)

## Channel facts

- Registry: `npm`
- Package: `@ctruhtech/verse-mcp`
- Version: `0.1.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Supply Chain Security**: 81/100
  - No malware found by supply-chain analysis.
  - CVE check failed: a known high-severity CVE affects zod 3.25.76, a direct dependency. A fixed version is available.
  - No install/post-install scripts declared.
  - 31 of 94 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 2 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 64/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 1795 tokens (~199/item across 9 items; 9 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 20/100
  - Stability observed for 6 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 97/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 90% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 10 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the Verse MCP server?

Verse runs locally as an npm package, launched with npx -y @ctruhtech/verse-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add dev-vinayagastya-verse-mcp -- npx -y @ctruhtech/verse-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "dev-vinayagastya-verse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ctruhtech/verse-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "dev-vinayagastya-verse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ctruhtech/verse-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add dev-vinayagastya-verse-mcp -- npx -y @ctruhtech/verse-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "dev-vinayagastya-verse-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@ctruhtech/verse-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add dev-vinayagastya-verse-mcp --command npx --arg -y --arg @ctruhtech/verse-mcp
```

### Hermes

```yaml
mcp_servers:
  dev-vinayagastya-verse-mcp:
    command: "npx"
    args: ["-y", "@ctruhtech/verse-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "dev-vinayagastya-verse-mcp": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "@ctruhtech/verse-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add dev-vinayagastya-verse-mcp -t stdio -c npx -a -y @ctruhtech/verse-mcp
```

### Other

```json
{
  "mcpServers": {
    "dev-vinayagastya-verse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ctruhtech/verse-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-20 (score 65, +2)

- [functional improvement] Stability: unverified → 0.17

### 2026-11-16 (score 63, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-11-15 (score 48)

First indexed and scored.

## MCP tools (9)

### `upload_scene` (~483 tokens)

Upload a 3D file and get a Verse link

Upload a 3D file and turn it into a shareable Verse link that opens in any browser. `source` is a local file path (stdio only) or a public http(s) URL the Verse server will fetch itself (Dropbox needs dl=1, Google Drive needs 'anyone with the link', S3/R2/GCS need a presigned URL). Accepts GLB, glTF, FBX, OBJ, IFC, USD/USDZ, PLY, SPLAT and point clouds (LAS/LAZ/E57). Large local files upload in resumable parts and survive dropped connections; progress is reported as notifications. By default the call waits for the build to finish and returns the link; if the build outlasts `wait_seconds` it returns the job id so you can poll get_scene_status. Result: `link` (open in a browser), `scene` (id), `status`.

Input parameters:

- `as` (string): Say what the file is: a 'product' (a single object) or a walkable 'interior'/'building'/'exterior'. Local uploads only; otherwise detected.
- `bake` (string): Bake lighting on the server before building (for live-lit GLBs). Slower.
- `kind` (string): Force the file kind when the extension is ambiguous (e.g. 'splat' for a Gaussian-splat .ply). Normally detected from the bytes.
- `name` (string): Optional slug used as the scene id prefix, lowercase letters, digits, - and _.
- `path` (string): 'fidelity' publishes the model as-is (best for single products); 'streamed' builds a streamed scene (best for big walkable scenes). Normally decided automatically.
- `resumable` (boolean): Force resumable multi-part upload (default: automatic above 100 MB). Use on flaky connections.
- `source` (string, required): Local file path (e.g. ~/Models/villa.glb) or a public http(s) URL to a 3D file.
- `visibility` (string): Set after the build finishes. Needs an account token. 'private' scenes only open with a share link from create_share_link.
- `wait_seconds` (integer): How long to wait for the build before returning the job id (0 = return right after upload).

### `get_scene_status` (~121 tokens)

Check a scene's build status

Check whether an uploaded scene has finished building. Returns `status` (compiling | done | error), the stage, progress 0..1, an ETA while building, and the `link` once done. Job records are kept for 2 hours after upload; older scenes are looked up in your account (needs VERSE_API_KEY).

Input parameters:

- `scene` (string, required): Scene id (e.g. palm-villa-0a1b2c3d4e5f), the job id returned by upload_scene, or a Verse share link.

### `list_scenes` (~59 tokens)

List your scenes

List the scenes owned by your Verse account, newest first: id, link, visibility, size, views and open review comments. Needs VERSE_API_KEY set to your account token.

Input parameters:

- `limit` (integer): Maximum number of scenes to return.

### `create_share_link` (~239 tokens)

Create a share link (set visibility)

Get a link to a scene you own, optionally changing who can open it. `visibility`: 'unlisted' (default; anyone with the link), 'public', or 'private' (opens only with a secret share token). For a private scene this mints a share token and returns a link that includes it (the token is shown once; keep the returned `shareId` to revoke it with revoke_share_link). Share links do not expire on their own; revoke them to cut access. Needs VERSE_API_KEY set to your account token.

Input parameters:

- `autoplay_tour` (boolean): Open the link playing the scene's camera path (see list_camera_paths).
- `new_token` (boolean): Mint a fresh private share token even if the scene is not private (e.g. to hand out revocable links).
- `scene` (string, required): Scene id (e.g. palm-villa-0a1b2c3d4e5f), the job id returned by upload_scene, or a Verse share link.
- `visibility` (string): Set the scene's visibility first. Omit to keep it as is.

### `revoke_share_link` (~115 tokens)

Revoke a private share link

Revoke one private share token so its link stops working. Use the `shareId` returned by create_share_link, or call with only `scene` to list the active share ids. Needs an account token.

Input parameters:

- `scene` (string, required): Scene id (e.g. palm-villa-0a1b2c3d4e5f), the job id returned by upload_scene, or a Verse share link.
- `share_id` (string): The shareId to revoke. Omit to list active ones.

### `get_embed_code` (~202 tokens)

Get embed code for a scene

Get copy-paste code to embed a scene in a web page: an `iframe` (works anywhere), the `<verse-viewer>` element plus its `script`, and the plain `url`. For a private scene pass the share token from create_share_link as `share_token`.

Input parameters:

- `aspect` (string): Frame shape. Default 16:9.
- `background` (string): 'rrggbb', 'transparent' or 'studio:warm'.
- `load` (string): 'lazy' (default) loads when scrolled into view, 'tap' only on tap, 'eager' immediately.
- `scene` (string, required): Scene id (e.g. palm-villa-0a1b2c3d4e5f), the job id returned by upload_scene, or a Verse share link.
- `share_token` (string): Share token of a private scene.
- `title` (string): Accessible title for the iframe.

### `list_camera_paths` (~112 tokens)

List a scene's camera paths

List the guided-tour camera paths of a scene (every scene gets an automatic default path after it builds) and the default one. Returns ids, names, modes (walk/fly), key counts and chapter labels, plus a ready-to-open `tourLink` that autoplays the default path.

Input parameters:

- `scene` (string, required): Scene id (e.g. palm-villa-0a1b2c3d4e5f), the job id returned by upload_scene, or a Verse share link.

### `set_camera_path` (~217 tokens)

Create a camera path (guided tour)

Create a camera path: a guided walk or fly-through the share link can play. Give 2 to 256 keyframes, each with an eye position `p`, forward direction `f` and optional fov, dwell `hold`, `ease`, look-at target and chapter `label`. The first path becomes the scene's default; set `make_default` to promote later ones. If you only want a good default tour, use reset_auto_camera_path instead. Owner only; needs an account token.

Input parameters:

- `keys` (array, required)
- `make_default` (boolean)
- `mode` (string): 'walk' keeps eye height over the floor and avoids walls; 'fly' goes anywhere.
- `name` (string)
- `scene` (string, required): Scene id (e.g. palm-villa-0a1b2c3d4e5f), the job id returned by upload_scene, or a Verse share link.
- `speed` (number): Metres per second for keys without `dur`.

### `reset_auto_camera_path` (~107 tokens)

Plan the automatic tour

Re-plan the scene's automatic camera path (an eye-height walkthrough for interiors, a drone fly-through for exteriors, a 360 orbit for products) and make it the default. Returns a link that autoplays it. Owner only; needs an account token.

Input parameters:

- `scene` (string, required): Scene id (e.g. palm-villa-0a1b2c3d4e5f), the job id returned by upload_scene, or a Verse share link.

## Diagnostics

Captured diagnostic sections: Provenance, Vulnerabilities, Dependencies. The full working is on the page: https://verifymcp.io/servers/dev-vinayagastya-verse-mcp/ctruhtech-verse-mcp#diagnostics

## Score history

- 2026-11-21: 65
- 2026-11-20: 65
- 2026-11-19: 63
- 2026-11-18: 63
- 2026-11-17: 63
- 2026-11-16: 63
- 2026-11-15: 48

## Common questions

### What is the Verse MCP server?

Verse is an MCP server listed in the public MCP registry as io.github.dev-vinayagastya/verse-mcp. Turn 3D files into shareable, embeddable Verse links from any AI assistant. This page covers its npm package (@ctruhtech/verse-mcp).

### Is the Verse MCP server safe to use?

Verse scores 65 out of 100 on VerifyMCP. We recorded 1 known advisory against it as of 21 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Verse MCP server expose?

Verse exposes 9 tools: upload_scene, get_scene_status, list_scenes, create_share_link, revoke_share_link, and 4 more. Their descriptions and schemas cost roughly 1,655 tokens of context every time the server is loaded.

### Is the Verse MCP server still maintained?

Verse is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the Verse MCP server under?

Verse declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

### What did VerifyMCP test on the Verse MCP server?

VerifyMCP ran 16 checks on Verse, covering Malware scan, Known CVEs, Install scripts, Dependency health and 12 more. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- npm package: https://www.npmjs.com/package/@ctruhtech/verse-mcp
- Socket report: https://socket.dev/npm/package/@ctruhtech/verse-mcp
- Repository: https://github.com/dev-vinayagastya/verse-mcp
- Changelog RSS feed: https://verifymcp.io/servers/dev-vinayagastya-verse-mcp/ctruhtech-verse-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/dev-vinayagastya-verse-mcp/ctruhtech-verse-mcp/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/dev-vinayagastya-verse-mcp/ctruhtech-verse-mcp.json
- HTML version of this page: https://verifymcp.io/servers/dev-vinayagastya-verse-mcp/ctruhtech-verse-mcp
