You do not need to know the tool names to work with the assistant. This list does help you understand what you can ask for and read what the assistant has done. Read tools work with any access scope. Saving tools require the Full editing scope and edit rights to the project.
Projects and guide
| Tool | What it does | Scope |
|---|---|---|
get_guide | Guide for the assistant: coordinate system, real dimensions, operations, warning codes, recipes. The assistant reads it once per conversation. | Read |
list_catalog | Item catalog: furniture and equipment, fixtures, environments, trusses, stage templates and technical catalogs (hoists, stands, devices, loudspeakers, amplifiers, cables, LED modules, acoustic materials). | Read |
list_projects | List of company projects available to you (optionally including the archive). | Read |
get_project | Reads a project: summary, list of objects with IDs and dimensions, or raw data of selected parts. | Read |
create_project | New project: empty with an environment (room, outdoor, technical view) or from a ready arrangement. | Edit |
update_project | Changes the project name and description. | Edit |
duplicate_project | Copy of a project, e.g. as an option. | Edit |
archive_project | Archives a project and restores it from the archive. | Edit + Manager role |
delete_project | Moves a project to the trash (restorable in the app for 30 days). Only on explicit request. | Edit + Manager role |
Scene
| Tool | What it does | Scope |
|---|---|---|
edit_scene | The main building tool. A batch of operations (up to 600): venue layout plan (room, walls, stage built from platforms, backstage, bar, lounge, tables, clear zones and evacuation routes, audience seating), LED screens and walls, furniture and equipment, fixture rows, solids, models, moving, deleting, duplicating, sources on screens, environment, camera, settings, catalog devices, report data, LED parameters, report document details. | Edit |
describe_scene | Spatial description for verification: top-down floor plan in characters, environment, camera, warnings (collisions, screens without an image, too many lights, objects below the floor). | Read |
list_video_sources | Sources to assign to screens: built-in demo and test materials, media uploaded to the project and live sources detected by your app. | Read |
upload_model | Uploads a 3D model (GLB, glTF, OBJ, FBX, STL, DAE) from a public https address or from data. edit_scene then places the model. | Edit |
upload_media | Uploads an image (png, jpg, webp, gif) or video (mp4, mov, webm) as a project source, optionally straight onto the given screens. | Edit |
Technical modules
| Tool | What it does | Scope |
|---|---|---|
get_rigging | Structures with full statics: spans, utilization and deflection, hoist and tower points, wind and ballast, parts list, warnings; light groups and fixtures on structures. | Read |
edit_rigging | Structures and lighting: adding a structure from a template (FOH, goal post, portal, frame, grid, mothergrid, ground support, roof, ring, stands), supports, loads, automatic fixes, mounting fixtures, loudspeakers and screens on the structure, distributing fixtures, lighting presets (front, back, side, wash, audience), aiming. | Edit |
get_cabling | Cabling analysis: power estimate, phases, power connection, generator, circuits with load, DMX lines and patch, LED processor ports, cable list, route zones, warnings. | Read |
edit_cabling | Cabling and power: automatic plan as in the app wizard, routes, zones (aisles, evacuation routes, no-cable zones), manual cables, power connection, DMX addresses, phases, warning fixes. | Edit |
get_control_room | Control room: type, dimensions, position, distance and sound delay to the stage, devices, power, warnings; optionally the connection diagram as text. | Read |
edit_control_room | Control room as in the app wizard: set for a conference, gala, concert or trade fair, automatic placement on the stage axis outside the audience seating and evacuation routes, devices, tables, fixes. | Edit |
get_audio | Sound system: loudspeaker systems, amplifiers, speaker cables, warnings; preview of the automatic system proposal without saving. | Read |
get_acoustics | Acoustic simulation of the listening area: SPL and STI statistics, reverberation time, recommended delays, exposure, warnings; optionally an SPL or STI map in characters. | Read |
edit_audio | Sound system and acoustics: inserting a system as in the app wizard, loudspeakers, L/R pairs, automatic angles, delays, amplifiers, audio cables, room acoustic parameters, fixes. | Edit |
get_report_summary | Project report (the same model as the report window): text, full data or an HTML document; section selection. | Read |
The edit_* tools accept a batch of operations, which is saved as a whole as one version. A batch that changes nothing (e.g. an automatic fix with no errors to fix) does not create a new version.
History and sharing
| Tool | What it does | Scope |
|---|---|---|
list_versions | Latest project versions: ID, date, type, label (e.g. "AI: …") and summary. | Read |
save_version | Names the current state as a version with a label, e.g. "Option A for approval". | Edit |
restore_version | Restores a version. The current state is saved as a "Restore point", so the operation can be reversed. | Edit |
get_viewer_link | Link to the browser preview for the client. | Read |
Guide and prompt template
Besides the tools, the server provides the guide as the stagedesigner://guide resource and a "Design an event" prompt template with one field for the brief. On connection the assistant also gets a short instruction: the order of work (stage, structures and lighting, control room, sound system, cabling last), conventions (meters, stage toward −Z, audience toward +Z) and the rule for passing on disclaimers.
