MCP tools

The Cerulion MCP server lists the tools below. Each tool’s full description, parameters and output schema come from the server itself (tools/list); this page is generated from the same text. Reach is where a call can go: this machine only, LAN discovery of other Cerulion hosts, a robot, or an internet service. See Connect an MCP client to install and configure the server.

Local tools

The CLI-backed tools: they run cerulion in the server workspace.

Tool	What it does	Reach
`guide`	Read the guide	this machine only
`workspace_create`	Create workspace	this machine only
`workspace_info`	Inspect workspace	this machine only
`workspace_init`	Initialize workspace	this machine only
`node_build`	Build node	this machine only
`node_create`	Create node	this machine only
`node_delete`	Delete node	this machine only
`node_info`	Inspect node	this machine only
`node_list`	List nodes	this machine only
`node_modify`	Modify node	this machine only
`node_run`	Run node	this machine, plus, unless network_off is true, a network gateway that announces every produced topic on the LAN, viewable by any peer without pairing
`node_stage`	Stage node	this machine only
`graph_create`	Create graph	this machine only
`graph_levels`	Show graph levels	this machine only
`graph_list`	List graphs	this machine only
`graph_partition`	Partition graph	this machine only
`graph_profile`	Profile graph	this machine only
`graph_run`	Run graph	this machine, plus, unless network_off is true, a network gateway: a graph with no enabled network: block announces every produced topic on the LAN, viewable by any peer without pairing
`graph_validate`	Validate graph	this machine only
`topic_echo`	Echo topic	this machine, plus LAN discovery of other Cerulion hosts unless no_network is true
`topic_hz`	Measure topic rate	this machine, plus LAN discovery of other Cerulion hosts unless no_network is true
`topic_info`	Inspect topic	this machine, plus LAN discovery of other Cerulion hosts unless no_network is true
`topic_list`	List topics	this machine, plus LAN discovery (multicast and gossip) unless no_network is true
`topic_watch`	Watch topic	this machine, plus LAN discovery of other Cerulion hosts unless no_network is true
`schema_create`	Create schema	this machine only
`schema_delete`	Delete schema	this machine only
`schema_info`	Inspect schema	this machine only
`schema_list`	List schemas	this machine only
`bag_info`	Inspect bag	this machine only
`bag_migrate`	Migrate bag	this machine only
`bag_play`	Play bag	this machine only
`bag_record`	Record bag	this machine only
`resim_compare`	Compare resimulations	this machine only
`resim_get_report`	Get resimulation report	this machine only
`resim_list_runs`	List resimulation runs	this machine only
`resim_run`	Run resimulation	this machine only
`flashback_capture`	Capture flashback	every live Cerulion graph on this host, not only this workspace’s
`viz_attach`	Attach visualizer	this machine, plus LAN discovery unless no_network is true; with robot set, that robot over the network
`studio_status`	Inspect Studio	this machine only
`studio_screenshot`	Screenshot Studio	this machine only
`studio_viewer_state`	Inspect Studio viewer	this machine only
`studio_ui_tree`	Inspect Studio UI	this machine only
`studio_set_time`	Seek Studio timeline	this machine only
`studio_click`	Click in Studio	this machine only
`studio_drag`	Drag in Studio	this machine only
`studio_scroll`	Scroll in Studio	this machine only
`studio_press_key`	Press key in Studio	this machine only
`account_login`	Log in to the Cerulion account	the Cerulion account service over the internet
`robot_connect`	Connect robot	the robot over the LAN or, by default, public relay servers on the internet
`robot_pair`	Pair robot	the robot over the LAN or relay servers; writes ~/.cerulion/desk.key and robots.toml, outside the workspace
`job_list`	List jobs	this machine only
`job_logs`	Read job logs	this machine only
`job_status`	Inspect job	this machine only
`job_stop`	Stop job	this machine only
`system_clean`	Clean system	this machine only
`system_cli`	Run CLI command	whatever the subcommand reaches (topic and viz verbs use LAN discovery)
`system_help`	Read CLI help	this machine only

Hindsight bag analysis

In release binaries (the default hindsight feature). They read MCAP bags in the workspace, or download one from an https:// URL over the internet first; CERULION_MCP_DISABLE_HINDSIGHT=1 hides them.

Tool	What it does	Reach
`open_bag`	Open bag	this machine, or the bag’s `https://` host over the internet
`get_debrief`	Get debrief	this machine, or the bag’s `https://` host over the internet
`query_index`	Query index (SQL)	this machine, or the bag’s `https://` host over the internet
`sample_messages`	Sample messages	this machine, or the bag’s `https://` host over the internet
`list_topics`	List topics	this machine, or the bag’s `https://` host over the internet
`find_anomalies`	Find anomalies	this machine, or the bag’s `https://` host over the internet
`scrub`	Scrub a time window	this machine, or the bag’s `https://` host over the internet
`get_foxglove_link`	Get Foxglove link	this machine, or the bag’s `https://` host over the internet

Cerulion Cloud (with `CERULION_CLOUD_API_URL` and `CERULION_CLOUD_TOKEN`)

Listed only when both variables are set. They call the Cerulion Cloud API over the internet with that token.

Tool	What it does	Reach
`cloud_whoami`	Cloud identity	Cerulion Cloud over the internet (needs the cloud token)
`cloud_instance_status`	Cloud instance status	Cerulion Cloud over the internet (needs the cloud token)
`cloud_instance_start`	Start cloud instance	Cerulion Cloud over the internet (needs the cloud token)
`cloud_instance_stop`	Stop cloud instance	Cerulion Cloud over the internet (needs the cloud token)
`cloud_instance_reboot`	Reboot cloud instance	Cerulion Cloud over the internet (needs the cloud token)
`cloud_instance_connect`	Connect to cloud instance	Cerulion Cloud over the internet (needs the cloud token)
`cloud_dcv_progress`	Read DCV progress	Cerulion Cloud over the internet (needs the cloud token)
`cloud_dcv_advance`	Advance DCV setup	Cerulion Cloud over the internet (needs the cloud token)
`cloud_dcv_reset`	Reset DCV setup	Cerulion Cloud over the internet (needs the cloud token)

Get started

Concepts

Guides

Studio and Hindsight

Reference

Community

Local tools

Hindsight bag analysis

Cerulion Cloud (with `CERULION_CLOUD_API_URL` and `CERULION_CLOUD_TOKEN`)

​Local tools

​Hindsight bag analysis

​Cerulion Cloud (with CERULION_CLOUD_API_URL and CERULION_CLOUD_TOKEN)

Local tools

Hindsight bag analysis

Cerulion Cloud (with `CERULION_CLOUD_API_URL` and `CERULION_CLOUD_TOKEN`)