Skip to content
Model VistaModel Vista MCP Module Documentation

Application tool reference

Discover the connected server’s tools before use. Tool availability and successful operation depend on the running application, loaded content, active mode, and licensed features.

Application-tool arguments are strings, including numbers and booleans such as "true", "10", and "0.5". Follow each tool’s discovered schema for required and optional arguments. The Variable Exposer tools use their own schemas.

Tool Use
list_libraries / select_library Discover and choose a model or background library; selection changes browsing.
list_library_models / load_model Discover source assets and load one by library asset ID or exact unique name.
list_loaded_models / select_model Discover scene instances and select one for runtime controls.
get_model Read visibility, transforms, selection, and locks.
set_model_visibility Show or hide a loaded model, subject to normal visibility rules.
set_model_transform Change position, rotation, or scale; use absolute or relative mode.
delete_model Remove a scene instance; the source library file is retained.
list_model_states / set_model_state Discover State groups/options and apply one; check selected-option readback.
get_model_animation Sample playback clocks without changing playback.
Tool Use
get_camera Read the desktop camera pose and lens.
set_camera_view Frame a model from one of six model-axis views.
frame_model Begin fitting a model along the current viewing direction.
move_camera / rotate_camera Move, look around, or orbit the desktop camera.
set_camera_fov Set the vertical perspective field of view.
get_xr_mode / set_xr_mode Read, enter, or exit XR and inspect transition state.

The camera controls require desktop mode. See views and XR for positioning and capture behavior.

Tool Use
list_windows / show_window Discover runtime panels and open one, optionally selecting a settings section.
hide_window Hide a panel or all; behavior follows the active interface layout.
show_library Show models or backgrounds thumbnails.
list_ui_scrolls / scroll_ui Discover visible scroll areas and scroll a current area ID.
capture_screenshot Return an application image preview and optionally save a PNG.
Tool Use
list_backgrounds / set_background Discover and load an environment by returned ID or exact unique name.
get_environment / set_environment Read supported settings and adjust one within its returned range.
get_graphics_options / set_graphics_option Discover supported graphics toggles and change one with actual readback.
get_turntable Read assignment, playback, angle, speed, and availability.
assign_model_to_turntable Assign a loaded model; inspect accepted and confirmed.
release_turntable_model Remove the assignment while keeping the model loaded.
set_turntable Set play, reverse, pause, angle, or speed. MCP speed values use degrees per second, from 0 to 30.

Networked assignment and release can remain pending after acceptance. Read get_turntable until the actual assignment matches the request. Pause before setting an angle when you need stable readback.