threejs-devtools-mcp
Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.
Needs to start: nothing
Returns a result when called with no setup: 0 of 5 tools tried
Contacts while installing and starting: nothing
What it contacted
Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.
Starting it
npx -y -p threejs-devtools-mcp@0.5.0 threejs-devtools-mcp
Installing a package runs its code. Use a sandbox for anything you have not read.
Calling its tools
5 tools that take no input and look read-only were called once with nothing. 0 returned a result.
find_objects | No usable answer tool reported an error: Error: No Three.js app connected. Open http://localhost:9222 in your browser. If the page is already open, try a hard refresh (Ctrl+Shif |
material_list | No usable answer tool reported an error: Error: No Three.js app connected. Open http://localhost:9222 in your browser. If the page is already open, try a hard refresh (Ctrl+Shif |
shader_list | No usable answer tool reported an error: Error: No Three.js app connected. Open http://localhost:9222 in your browser. If the page is already open, try a hard refresh (Ctrl+Shif |
texture_list | No usable answer tool reported an error: Error: No Three.js app connected. Open http://localhost:9222 in your browser. If the page is already open, try a hard refresh (Ctrl+Shif |
renderer_info | No usable answer tool reported an error: Error: No Three.js app connected. Open http://localhost:9222 in your browser. If the page is already open, try a hard refresh (Ctrl+Shif |
During the calls it contacted nothing it had not already contacted.
Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.
What its tools tell an agent
In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.
Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.
Tools
scene_tree depth, types, maxChildren, compact
[INSPECT] Read-only. Scene hierarchy. Compact text tree by default (~2KB); compact=false for full JSON with positions/geometry.
object_details name, uuid, path
[INSPECT] Read-only. Detailed info about one object by name, uuid, or dot path.
find_objects type, material, visible, namePattern, property, value, hasGeometry, minChildren, limit
[INSPECT] Read-only. Search objects by type, material, visibility, name pattern, or custom property.
raycast x, y, maxHits
[INSPECT] Read-only. Cast a ray from the camera through screen coordinates and return hit objects.
click_inspect timeout
[INSPECT] Read-only. Click-to-inspect: the cursor becomes a crosshair — tell the user to click an object in the 3D view. Returns that object.
64 more tools
scene_diff action
[INSPECT] Read-only. Compare scene state over time: first call saves a snapshot, next call lists added/removed/modified objects.
layer_details
[INSPECT] Read-only. Camera layer mask and objects with non-default layers.
set_object_transform name, uuid, position, rotation, scale, visible
[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes. Set position, rotation, scale, or visibility of an object.
set_layers name, uuid, target, layer, enabled, mask
[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes. Set layers on an object or the camera.
material_list
[INSPECT] Read-only. All materials in the scene with type, color, transparency.
material_details name, uuid
[INSPECT] Read-only. Full material properties: colors, PBR/physical params, maps, uniforms, defines, NodeMaterial (TSL) slots.
shader_list
[INSPECT] Read-only. Compiled shader programs with their materials (WebGL).
shader_source materialName, materialUuid
[INSPECT] Read-only. Vertex/fragment GLSL source and uniforms of a material. NodeMaterial (TSL) has no GLSL — use material_details.
texture_list
[INSPECT] Read-only. All textures: size, format, wrap, filter settings.
texture_details name, uuid
[INSPECT] Read-only. Detailed info about one texture.
texture_preview name, uuid, maxSize
[INSPECT] Read-only. Show a texture as a PNG image. Use texture_list to find names/UUIDs.
set_material_property name, uuid, property, value
[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes. Set a material property. Accepts the material name or the name of a mesh that uses it.
set_uniform name, uuid, uniform, value
[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes. Set a ShaderMaterial uniform.
set_texture name, uuid, wrapS, wrapT, minFilter, magFilter, anisotropy, flipY, colorSpace, repeat, offset, rotation
[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes. Change texture sampling and transform: wrap, filter, anisotropy, repeat, offset, rotation, colorSpace.
shadow_details
[INSPECT] Read-only. Shadow maps: global settings, per-light bias/mapSize/camera frustum, casters and receivers.
scene_background
[INSPECT] Read-only. Scene background, environment map (IBL), backgroundBlurriness/Intensity, color management.
env_map_details
[INSPECT] Read-only. Environment maps: scene.environment, scene.background, per-material envMap.
fog_details
[INSPECT] Read-only. Scene fog: type (Fog/FogExp2), color, near/far or density.
set_light name, uuid, color, intensity, position, castShadow, groundColor
[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes. Change a light: color, intensity, position, castShadow, groundColor (HemisphereLight).
set_shadow name, uuid, castShadow, receiveShadow, bias, normalBias, radius, blurSamples, mapSize, cameraNear, cameraFar, cameraLeft, cameraRight, cameraTop, cameraBottom
[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes. Change shadow casting/receiving on any object, and bias/mapSize/shadow camera on lights.
set_fog color, near, far, density, background
[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes. Change scene fog (color, near/far or density) and the background color.
camera_details
[INSPECT] Read-only. Active camera: type, position, FOV, near/far, aspect.
renderer_info
[INSPECT] Read-only. Renderer stats and backend (WebGL / WebGPU): draw calls, triangles, memory, capabilities.
renderer_settings
[INSPECT] Read-only. Renderer configuration: toneMapping, exposure, colorSpace, shadowMap, pixelRatio.
clipping_details
[INSPECT] Read-only. Clipping planes: renderer global, per-material, ClippingGroup objects.
postprocessing_list
[INSPECT] Read-only. EffectComposer passes: render passes, shader passes, effects (bloom, SSAO, …).
set_camera position, rotation, fov, near, far, zoom, aspect, left, right, top, bottom
[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes. Change the active camera: position, rotation, FOV, near/far, zoom, ortho bounds.
set_renderer toneMapping, toneMappingExposure, outputColorSpace, pixelRatio, sortObjects, localClippingEnabled, shadowMapEnabled, shadowMapType
[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes. Change renderer settings: tone mapping, exposure, color space, pixel ratio, shadows.
set_clipping target, name, uuid, localClippingEnabled, planes, clipIntersection, clipShadows, enabled
[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes. Change clipping planes on the renderer (global) or a material.
set_postprocessing passIndex, passName, enabled, uniforms, effectIndex, effectParams
[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes. Enable/disable passes, set pass uniforms or effect parameters. Without a pass, lists passes.
geometry_details name, uuid
[INSPECT] Read-only. Geometry of a mesh: vertices, attributes, index, bounding box, morph attributes.
instanced_mesh_details name, uuid, sampleCount, startIndex
[INSPECT] Read-only. InstancedMesh: count, capacity, sample transforms, instance colors and custom attributes.
batched_mesh_details name, uuid
[INSPECT] Read-only. BatchedMesh: geometry counts, draw ranges, instance visibility. Lists all if no name/uuid.
morph_targets
[INSPECT] Read-only. Meshes with morph targets: target names and current influences.
skeleton_details
[INSPECT] Read-only. Skeletons and bones of SkinnedMesh objects.
animation_details
[INSPECT] Read-only. AnimationMixers with their actions, clips, weights and playback state.
set_instanced_mesh name, uuid, count, visible, frustumCulled
[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes. Change InstancedMesh count, visibility, frustumCulled.
set_morph_target name, uuid, index, targetName, influence
[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes. Set a morph target influence.
set_animation mixerIndex, timeScale, time, clipName, actionWeight, actionTimeScale, actionPaused, play, stop
[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes. Control playback: mixer timeScale/time, action play/stop/pause/weight by clip name.
web_audit
[INSPECT] Read-only. Website health check: pixel ratio, canvas resize, idle/off-screen rendering, antialias cost, oversized or uncompressed textures, shadow cost, color space, draw calls. Each finding has a concrete fix.
performance_snapshot
[INSPECT] Read-only. Draw calls, triangles, instanced meshes, object counts by type.
perf_monitor duration, includeFrameTimes
[INSPECT] Read-only. Record FPS and frame times for N seconds: avg/min/max, percentiles, spikes, jank.
draw_call_breakdown
[INSPECT] Read-only. Per-object draw call and triangle cost, sorted by cost. Flags multi-material objects and hidden geometry.
memory_stats
[INSPECT] Read-only. GPU memory: geometry buffers, texture VRAM, instance data, top textures by size.
dispose_check
[INSPECT] Read-only. Leak detection: geometries/textures tracked by the renderer but no longer in the scene.
console_capture clear, level, limit
[INSPECT] Read-only. Recent browser console output (log/warn/error).
toggle_overlay enabled
[DEBUG VISUAL] Temporary visual aid in the browser. Nothing to put in code. In-browser inspector panel: live FPS, draw calls, scene tree, materials, lights. Clicking a tree item highlights it.
overlay_selected
[INSPECT] Read-only. Everything about the object the user selected in the overlay: materials, geometry, transforms, textures, uniforms, shadows.
highlight_object name, uuid, mode, enabled
[DEBUG VISUAL] Temporary visual aid in the browser. Nothing to put in code. Highlight an object with wireframe, or toggle its visibility, to point it out.
toggle_wireframe name, uuid, enabled
[DEBUG VISUAL] Temporary visual aid in the browser. Nothing to put in code. Wireframe on all materials or one object.
bounding_boxes name, uuid, enabled, clear, color, recursive, onlyVisible, limit
[DEBUG VISUAL] Temporary visual aid in the browser. Nothing to put in code. Show/hide bounding boxes — debug frustum culling and object bounds.
add_helper target, targetUuid, type, size, color, direction, origin, length, divisions
[DEBUG VISUAL] Temporary visual aid in the browser. Nothing to put in code. Add a debug helper to an object: box, axes, skeleton, arrow, grid, camera frustum, light helpers, plane.
remove_helper helperId
[DEBUG VISUAL] Temporary visual aid in the browser. Nothing to put in code. Remove a helper added with add_helper.
run_js code
[DEBUG VISUAL] Temporary visual aid in the browser. Nothing to put in code. Run JavaScript in the page with scene, renderer, camera, gl in scope; `return` a value to get it back. Changes made here are NOT recorded in pending_changes — prefer the set_* tools for anything the user may want to keep.
take_screenshot width, height
[INSPECT] Read-only. Screenshot of the current scene (also saved as PNG in screenshots/).
annotated_screenshot width, height
[INSPECT] Read-only. Screenshot with object names drawn at their screen positions ([M]esh, [L]ight, [G]roup, [C]amera). Best for understanding layout.
capture_frames fps, duration, format, width, height
[INSPECT] Read-only. Record a frame sequence for a video. Time is virtualised, so frames are exactly 1/fps apart and smooth even if rendering is slow. Saves numbered images to screenshots/sequence-<time>/ and returns an ffmpeg command.
scene_export name, uuid, binary
[INSPECT] Read-only. Export the scene or one object as GLB/glTF into screenshots/. Needs GLTFExporter in the app (the error explains setup).
pending_changes style, clear
[FOR CODE] Output is meant to be written into the project source files. Everything changed with live-preview tools since the last clear: before → after per property, plus ready-to-paste code (vanilla Three.js and/or React Three Fiber) and where to find each target. Use it to persist a preview into source; call again with clear=true once the code is updated.
revert_changes ids
[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes. Undo live-preview changes in the browser (all, or selected ids from pending_changes), newest first.
gltf_to_r3f filePath, typescript, preload
[FOR CODE] Output is meant to be written into the project source files. Convert a GLB/glTF file into a React Three Fiber component (like gltfjsx).
bridge_status
[CONNECTION] Configures the devtools server. Bridge connection, proxy target, and how to attach Playwright to the same browser.
set_dev_port port
[CONNECTION] Configures the devtools server. Point the proxy at another local dev server port.
set_dev_url url
[CONNECTION] Configures the devtools server. Inspect a remote Three.js app by URL. Source code changes are not possible in remote mode.
Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.
Install facts
| License | MIT |
|---|---|
| Needs | node >=22.18 |
| Source | github.com/DmitriyGolub/threejs-devtools-mcp |
| Install scripts | None declared by it or anything installed with it. |
| Tarball | sha512-z27jf+a+5A5qgnVFAfUzy827SStziV+VQXXVUhOyQ/+gBxJvgoQ4KNMnV2QqrDjEPEfihvsSIKdNWq9+TGMPSQ== |
Check this report yourself
This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.
Report as JSONExact text and tokenHow to verify it
Show it on your README
[](https://bragproof.smaverk.com/r/threejs-devtools-mcp)
New version out? Ask for a fresh report.