StageDesigner

AI assistant tools

All tools of the StageDesigner MCP server: what they read, what they change and what access scope they require.

4 min read
Documentation contents ▾

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

ToolWhat it doesScope
get_guideGuide for the assistant: coordinate system, real dimensions, operations, warning codes, recipes. The assistant reads it once per conversation.Read
list_catalogItem catalog: furniture and equipment, fixtures, environments, trusses, stage templates and technical catalogs (hoists, stands, devices, loudspeakers, amplifiers, cables, LED modules, acoustic materials).Read
list_projectsList of company projects available to you (optionally including the archive).Read
get_projectReads a project: summary, list of objects with IDs and dimensions, or raw data of selected parts.Read
create_projectNew project: empty with an environment (room, outdoor, technical view) or from a ready arrangement.Edit
update_projectChanges the project name and description.Edit
duplicate_projectCopy of a project, e.g. as an option.Edit
archive_projectArchives a project and restores it from the archive.Edit + Manager role
delete_projectMoves a project to the trash (restorable in the app for 30 days). Only on explicit request.Edit + Manager role

Scene

ToolWhat it doesScope
edit_sceneThe 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_sceneSpatial 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_sourcesSources to assign to screens: built-in demo and test materials, media uploaded to the project and live sources detected by your app.Read
upload_modelUploads 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_mediaUploads an image (png, jpg, webp, gif) or video (mp4, mov, webm) as a project source, optionally straight onto the given screens.Edit

Technical modules

ToolWhat it doesScope
get_riggingStructures 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_riggingStructures 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_cablingCabling analysis: power estimate, phases, power connection, generator, circuits with load, DMX lines and patch, LED processor ports, cable list, route zones, warnings.Read
edit_cablingCabling 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_roomControl room: type, dimensions, position, distance and sound delay to the stage, devices, power, warnings; optionally the connection diagram as text.Read
edit_control_roomControl 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_audioSound system: loudspeaker systems, amplifiers, speaker cables, warnings; preview of the automatic system proposal without saving.Read
get_acousticsAcoustic 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_audioSound 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_summaryProject 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

ToolWhat it doesScope
list_versionsLatest project versions: ID, date, type, label (e.g. "AI: …") and summary.Read
save_versionNames the current state as a version with a label, e.g. "Option A for approval".Edit
restore_versionRestores a version. The current state is saved as a "Restore point", so the operation can be reversed.Edit
get_viewer_linkLink 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.

Did not find the answer?
Describe the problem and we will reply with a solution or add an article.