Spaces tools
The Spaces contract: register, claim and release Spaces, run commands, move files, stream, run agents and teleport.
The Spaces contract: register, claim and release Spaces, run commands, move files, stream, run agents and teleport.
These tools are the Spaces contract, with the same names and schemas on every surface. Each links to its entry there (parameters, result, errors, providers, metering); cua mcp gates each one behind the permission spaces:<tool>.
Full entries: Space lifecycle.
| Tool | Description |
|---|---|
add_space | Add an existing machine as a Space by address and token. |
remove_space | Forget a registered Space without touching it. |
list_spaces | List the Spaces this connection can see. |
create_space | Create a Space: a new sandbox on this machine, on one of your machines, or in the cloud. |
delete_space | Delete a Space's sandbox and forget it. |
stop_space | Turn a Space off: suspend it (memory kept) or stop it (disk kept). |
start_space | Turn a Space back on: resume or boot it. |
Full entries: Commands and files.
| Tool | Description |
|---|---|
space_bash | Run a shell command inside the Space. |
space_write | Write literal text to a path inside the Space. |
upload | Send a local file or folder into the Space. |
send_file | Send a host file or folder into the Space's Downloads, verified by sha256 on arrival. |
download | Fetch a file or folder out of the Space. |
Full entries: Streams and display.
| Tool | Description |
|---|---|
stream_endpoint | Return a ticketed media endpoint for the Space's desktop or one window. |
list_space_windows | List the windows open inside the Space. |
stream_space_window | Draw one Space window on the operator's desktop. |
show_space_pip | Pin the Space as picture-in-picture on the operator's desktop. |
hide_space_pip | Unpin the picture-in-picture window. |
open_space_viewer | Open the full Space viewer on the operator's desktop. |
Full entries: Services.
| Tool | Description |
|---|---|
list_tools | List the MCP services and tools reachable inside the Space. |
call_tool | Call a service tool inside the Space. |
Full entries: Agents.
| Tool | Description |
|---|---|
agent_start | Start a coding agent in the Space. |
agent_message | Send a follow-up to an agent run. |
agent_events | Read an agent run's events after a cursor. |
agent_status | Read an agent run's status and result. |
agent_interrupt | Interrupt an agent run's current turn. |
agent_stop | Stop an agent run. |
agent_list | List agent runs in the Space. |
agent_capabilities | Report what the agent harnesses support. |
Full entries: Persistent agents.
| Tool | Description |
|---|---|
persistent_agent_create | Create a named agent whose memory outlives its Space. |
persistent_agent_list | List persistent agents. |
persistent_agent_remove | Forget a persistent agent. |
persistent_agent_send | Give a persistent agent a turn. |
persistent_agent_save | Save a persistent agent's home now. |
agent_pause | Pause a persistent agent: its run, its routines and its Space. |
agent_resume | Resume a paused persistent agent. |
routine_add | Schedule a recurring turn for a persistent agent. |
routine_list | List routines. |
routine_remove | Delete a routine. |
routine_set_enabled | Turn a routine on or off. |
notify_user | Tell the user something in the Cua app. |
notifications_list | Read the notifications feed. |
notifications_ack | Mark notifications read. |
computer_access_grant | Let a persistent agent use one of the user's computers. |
computer_access_revoke | Take back a persistent agent's access to a computer. |
computer_access_list | List per-agent computer access. |
Full entries: Session teleport.
| Tool | Description |
|---|---|
teleport_manifest | Describe what a session teleport would move. |
teleport_app | Move an app session into the Space. |
Full entries: Keyvault.
| Tool | Description |
|---|---|
request_site_login | Sign in to a site in the Space with the user's saved password. |
Full entries: Hotspot.
| Tool | Description |
|---|---|
hotspot_start | Start sharing this machine's network with a Space. |
hotspot_stop | Stop sharing this machine's network. |
hotspot_status | Report which Spaces are sharing this machine's network, with counters. |
Full entries: Cua Volume.
| Tool | Description |
|---|---|
volume_ls | List a folder of the Cua Volume. |
volume_read | Read a file from the Cua Volume. |
volume_write | Write a file to the Cua Volume. |
volume_delete | Delete a file from the Cua Volume. |
volume_history | List a Cua Volume file's versions. |
volume_restore | Restore an old version of a Cua Volume file. |
volume_grant | Grant an agent or Space more Cua Volume access. |
volume_revoke | Revoke a Cua Volume grant. |
volume_grants | List Cua Volume grants. |
volume_request_access | Ask the user for more Cua Volume access. |
volume_requests | List Cua Volume access requests waiting for the user. |
volume_approve | Approve a Cua Volume access request. |
volume_deny | Decline a Cua Volume access request. |
volume_audit | Read the Cua Volume audit log. |
volume_storage | Show where the Cua Volume keeps its bytes. |
volume_storage_set | Test or change where the Cua Volume keeps its bytes. |
volume_mount_status | Show whether the Cua Volume is mounted as a volume. |
volume_mount | Mount the Cua Volume as a volume. |
volume_unmount | Unmount the Cua Volume volume. |
volume_sync_status | Show the Cua Volume's sync state across devices. |
volume_sync_events | Wait for Cua Volume sync events. |
volume_sync_resolve | Mark a Cua Volume sync conflict as seen. |
volume_cache_stats | Show the Cua Volume block cache. |
volume_cache_set | Set the Cua Volume block cache's size cap. |
volume_cache_clear | Clear the Cua Volume block cache. |
Full entries: Sharing.
| Tool | Description |
|---|---|
share_space | Let another cua.ai account watch or edit a Space. |
unshare_space | Stop sharing a Space with an account, or with everyone. |
space_shares | List who a Space is shared with. |
relay_register_space | Publish a Space on the relay for the account's other devices. |
relay_unregister_space | Take a Space off the relay. |
Full entries: Your cloud.
| Tool | Description |
|---|---|
cloud_status | List your clouds (AWS, Google Cloud, Modal): found credentials, the connected account and region, what each can run at what hourly cost, and what Cua created there. |
cloud_connect | Connect a cloud account Spaces can be created in. |
cloud_test | Check a cloud account without creating anything. |
cloud_disconnect | Forget a connected cloud account. |
cloud_sweep | Find and delete what Cua left in your clouds. |
Served by cua mcp; see MCP tools for every tool.