This page lists every tool the MCP Server offers. Agents read the full description and input schema of each tool from the server, so you do not need to pass these names in prompts. They are useful for understanding what an agent did, or for calling the server from your own scripts.
Common Rules
These rules apply to every tool:
Open project: Simulation tools work on the open project. On the Home Screen they return No project simulation is open.
Editing while reset: Tools that change the simulation only run while it is reset. Otherwise they return The simulation must be reset before objects or initial conditions can be changed.
IDs: Objects, components, models, behaviors, power buses, messages, and events are identified by GUIDs. Listing tools return them.
Units: Positions are in meters, times in seconds, and rotations in degrees, unless a tool says otherwise.
Names: Tool names are not case-sensitive. Class, model, behavior, and message names accept several forms, such as NadirPointingSoftware or Nadir Pointing.
Errors: A tool that cannot complete a request returns an error result with the reason, and the request is logged as a warning in the Console Panel. Nothing is changed by a rejected request.
In the tables below, Any time tools can be called while the simulation is running, paused, or reset. Reset tools change the simulation and need it reset.
Simulation
Tool
Purpose
Allowed
simulation_state
Report the state, time, requested and achieved speed, duration, step size, epoch, and UTC date.
Any time
simulation_controls
Start, pause, stop, or reset, and set speed, duration, pause at duration, and step size.
Any time
simulation_epoch
Set the simulation epoch as a UTC date and time.
Reset
simulation_database
Report or change database recording and its sample interval.
Read any time, change while reset
simulation_save
Write the simulation to a .json simulation file.
Any time
simulation_export
Export the whole Studio project to a .zen file. Counts as saving the project.
Any time, mid-run exports keep the state from before the run
simulation_load
Replace the simulation with a .json simulation file.
Reset
project_info
Report or change the project’s name, description, and categories. Changes are unsaved until the project is saved.
Read and change description or categories any time, rename while reset
Objects
Tool
Purpose
Allowed
inventory_list
Search Inventory items, optionally only those that fit a parent.
Any time
class_list
List the object classes that can be created, optionally for a parent.
Any time
object_create
Create an object from an Inventory item or a class, at the root or on a parent.
Reset
object_list
List root objects, every object, or the children of a parent.
Any time
object_delete
Delete an object and everything attached to it.
Reset
spacecraft_orbit
Set a spacecraft’s starting orbit from classical, Cartesian, or geodetic values.
Reset
Variables
Tool
Purpose
Allowed
variable_list
List an object’s variables with their types and whether they are read-only.
Any time
variable_get
Read one variable.
Any time
variable_set
Change one variable. Object and message references take a GUID.
Reset
Viewport
Tool
Purpose
Allowed
screenshot
Capture the Studio window, including its panels, as an image.
Any time
viewport_focus
Select an object or planet and frame it in the viewport.
Any time
viewport_state
Report the viewport selection and camera targets.
Any time
Panels
Panel tools change the main window only. Panels and sections are identified by instance IDs from layout_state, which are not saved with the project.
Tool
Purpose
Allowed
panel_list
List the panels that can be opened, with descriptions and open instances.
Any time
layout_state
Report the main window layout, fullscreen panel, presets, and torn-off windows.
Any time
layout_set
Replace the whole layout. Panels left out are closed.
Any time
layout_preset
List layout presets, or apply one by name.
Any time
panel_open
Open a panel as a tab, beside a section, or along an edge.
Any time
panel_move
Move a panel, keeping its state, or reorder its tab.
Any time
panel_close
Close a panel. Its state is lost.
Any time
panel_focus
Bring a panel to the front and give it focus.
Any time
panel_fullscreen
Show one panel fullscreen, or restore the layout.
Any time
Power
Tool
Purpose
Allowed
power_bus_create
Create a power bus, optionally wiring its components automatically.
Reset
power_bus_state
Report a bus’s components, wires, voltages, currents, and power.
Any time
power_bus_connect
Wire two components on a bus.
Reset
power_bus_disconnect
Remove a wire between two components.
Reset
power_bus_remove
Take a component off a bus, optionally closing the circuit around it.
Reset
power_bus_replace
Move a component’s wires to another component.
Reset
power_bus_autoconnect
Wire every power component on the spacecraft automatically.
Reset
power_bus_delete
Delete a bus and its wiring, keeping the components.
Reset
power_interconnect_link
Link or unlink two power interconnects so buses share power.
Reset
Models
Tool
Purpose
Allowed
model_list_available
List the models an object supports and whether each is attached.
Any time
model_list
List the models attached to an object.
Any time
model_get
Get a model and its variables, attaching it first while reset.
Any time
model_enable
Enable a model, attaching it first if needed.
Reset
model_disable
Disable a model.
Reset
Behaviors
Tool
Purpose
Allowed
behaviour_list_available
List the behaviors that can be created, with their inputs and outputs.
Any time
behaviour_list
List the behaviors on an object.
Any time
behaviour_get
Get a behavior with its inputs, outputs, and variables.
Any time
behaviour_create
Create a behavior, such as flight software, on an object.
Reset
behaviour_enable
Enable a behavior.
Reset
behaviour_disable
Disable a behavior.
Reset
behaviour_delete
Delete a behavior and clear inputs that read its outputs.
Reset
Messages
Tool
Purpose
Allowed
message_list
List an object’s inputs and outputs and their connections.
Any time
message_sources
Find the outputs that can be connected to an input.
Any time
message_connect
Connect an input to an output.
Reset
message_disconnect
Clear an input.
Reset
Events
Tool
Purpose
Allowed
event_list
List events with their triggers, actions, tags, and firings.
Any time
event_create
Create an event from timer and flag triggers and set or action actions.
Reset
event_enable
Enable or disable an event.
Reset
event_delete
Delete an event. Built-in events cannot be deleted.
Reset
object_actions
List the actions an object can perform.
Any time
world_events
Report or change the built-in eclipse, passover, and altitude warning events.
Read any time, change while reset
Telemetry
Tool
Purpose
Allowed
telemetry_history
Read recorded values over a time window, with a summary.
Any time, after recording
telemetry_export
Write an object’s recorded values and output messages to CSV files.
