boxes-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LIBVIRT_URI | No | The libvirt connection URI (e.g., qemu:///system or qemu:///session) | qemu:///system |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| boxes.listA | List all libvirt domains (VMs) managed by GNOME Boxes/libvirt |
| boxes.infoB | Get detailed domain info |
| boxes.startC | Start a domain (VM) |
| boxes.shutdownA | Shutdown/Power off a domain (graceful by default) |
| boxes.rebootB | Reboot a running domain |
| boxes.suspendC | Suspend a running domain |
| boxes.resumeC | Resume a suspended domain |
| boxes.undefineA | Undefine a domain (remove from libvirt). Storage is NOT deleted. |
| boxes.snapshots.listA | List snapshots for a domain |
| boxes.snapshots.createB | Create a snapshot for a domain |
| boxes.snapshots.revertB | Revert a domain to a snapshot |
| boxes.snapshots.deleteB | Delete a snapshot |
| boxes.displayA | Get SPICE/VNC display address for VM (useful to open viewer) |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 13 tools
Each tool targets a distinct action (e.g., start, shutdown, snapshot operations) with no overlap. Snapshots are namespaced under 'snapshots' to further differentiate from domain-level actions.
All tools follow a consistent 'boxes.<action>' pattern, with snapshot sub-tools using 'boxes.snapshots.<action>'. Names are lowercase with dots and use verbs for actions (list, create, delete).
13 tools is well-scoped for managing libvirt domains, covering lifecycle, snapshots, and info display. The number feels complete without being excessive.
Core VM lifecycle (start, shutdown, reboot, suspend, resume, undefine) and snapshot CRUD are covered. Missing domain modification (e.g., edit config) is a minor gap, but the set handles essential operations.