Check the Vectorworks bridge: returns Vectorworks version, active document and bridge version. Warns if the installed bridge doesn't match this server.

Run arbitrary Python inside Vectorworks with vs in scope.

Returns stdout, the value of the last expression (or of a variable named result), and the traceback if it raised. Vectorworks embeds Python 3.9. Handles are only valid during the call; return UUIDs (vs.GetObjectUuid) to refer to objects later. A wrong vs.* signature can pop a modal "Script Errors" dialog in Vectorworks instead of raising; check with vw_vs_lookup first. Set modifies_document=False for read-only code; otherwise vw_revert_last can't step past this call.

Search the live vs.* API (names and built-in docs) of the running Vectorworks, e.g. "record field", "symbol insert", "LDevice". Returns function names with their signature/description.

Active document: name, path, units, active layer/class, counts, selection size.

All layers (design and sheet) with visibility and which one is active.

All class names, optionally filtered by a case-insensitive substring.

Selected objects on the active layer: uuid, type, name, class, layer, bbox, attached records, and symbol / plug-in name where relevant.

Find objects by any combination of exact class, layer, type ("Symbol", "Rectangle", "Plug-in Object"...), plug-in name ("Lighting Device"), attached record (optionally with field == value) and object name.

All field values of a record (or a plug-in object's parameters, using its plug-in name as the record) on the object with this UUID.

Set record fields (or plug-in parameters) on one object; unknown field names are rejected before anything changes. One undo step. Returns the record afterwards.

Symbol definitions in the document's resource list, with their folder path; filter by name and/or folder substring (e.g. fixture lookup).

Place a symbol from the document's resources at x, y (document units), optionally at height z, on a layer and in a class. One undo step.

Undo exactly the last MCP write in the active document: restores the previous field values of vw_set_record / vw_set_lighting_device_fields, or deletes the symbol vw_insert_symbol placed. Call repeatedly to step further back. (Vectorworks' own Cmd-Z merges consecutive MCP edits.) Raw vw_exec_python edits can't be reverted this way.

All Spotlight Lighting Devices, sorted by position then unit number.

Default fields: Unit Number, Channel, Dimmer, Universe, DMX Address, UniverseAddress, Absolute Address, Num Channels, Purpose, Position, Inst Type, Wattage, Color, Template (gobo), Template2, Focus, Circuit Number/Name, Mark, Symbol Name, Fixture Mode, GDTF Fixture Name, Device Type, User Field 1-6. Pass fields to choose others (any Lighting Device parameter name). Filter by exact position name or layer. Each row has a uuid.

Bulk-edit Lighting Device fields in one undo step.

updates is a list of {selector, "fields": {name: value}} where selector is one of: "uuid"; "position" + "unit_number" (unit numbers repeat per position); "unit_number" alone if unique; or "channel" if unique. Example: [{"position": "1E", "unit_number": "3", "fields": {"Channel": "101", "Color": "R02"}}].

All selectors and field names are validated first; if any fail, nothing changes. Revert exactly this call with vw_revert_last. Universe / DMX Address edits are applied via UniverseAddress (Spotlight's source of truth). Returns before/after per device as re-read from Vectorworks, with not_applied listing anything Spotlight overrode.

Lighting positions (Light Position Obj, Lighting Pipe, Ladder, Truss, Hanging Position) with the devices whose Position field names them. Also reports how many devices have no position, and position names used by devices that have no matching position object.

Paperwork export of Lighting Devices (channel hookup, instrument schedule...). Default columns: Position, Unit Number, Inst Type, Wattage, Purpose, Channel, UniverseAddress, Circuit Number, Color, Template, Focus. Sorted naturally by sort_by (blank values last). Returns the CSV/JSON text, and also writes it to output_path if given.