Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PORTAINER_API_KEYYesAPI key for Portainer, used to manage Docker stacks

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
completions
{}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_system_infoA

OMV/host info: hostname, OMV version, kernel, CPU, memory, uptime, load.

disk_usageA

Human-readable filesystem usage (df -h).

list_block_devicesA

Block devices with size/model/serial/fs/mountpoint/uuid (lsblk -J).

top_processesA

Top processes by cpu or mem (ps, fast). sort_by is 'cpu' or 'mem'.

memory_infoB

RAM and swap usage in bytes (free -b).

available_updatesA

APT packages with pending upgrades (name/versions only). {count, packages}.

service_statusB

systemd active/enabled state per unit (systemctl, fast). Defaults to a common NAS set if none given.

service_logsA

Last lines journal entries for a systemd unit (journalctl -u).

network_infoA

Network interfaces with addresses (ip -j addr); virtual docker/veth interfaces are filtered out for signal.

run_commandA

Run an arbitrary shell command on the NAS as root. UNRESTRICTED and UNGUARDED -- there is no allow/deny-list. Prefer the specific tools (omv_rpc, docker, stacks) over hand-editing config. Returns {stdout, stderr, exit_code}.

apply_updatesA

Install pending APT upgrades (apt-get -y upgrade, noninteractive). Requires confirm=True. Run available_updates first to see what changes. Returns {exit_code, output}.

rebootA

Reboot the NAS. Requires confirm=True.

shutdownA

Power off the NAS. Requires confirm=True.

list_filesystemsA

All filesystems OMV knows about (mounted or not).

list_disksB

Physical disk devices known to OMV.

smart_statusB

S.M.A.R.T. overview per device (overall health status, from OMV).

smart_healthA

SMART overall-health self-assessment for one device (PASSED/FAILED). device is 'sda' or '/dev/sda'.

smart_attributesA

Full SMART attribute table for one device (smartctl -A), plus current temperature and power-on hours. device is 'sda' or '/dev/sda'.

smart_selftest_logB

SMART self-test history for one device (smartctl -l selftest).

disk_temperaturesA

Current temperature (°C) of every physical disk (smartctl -A per disk).

run_smart_testA

Start a SMART self-test on a device. kind is 'short', 'long', or 'conveyance'. The test runs in the background (adds drive load); poll results later with smart_selftest_log. Requires confirm=True.

cpu_tempB

CPU temperature in °C (OMV CpuTemp plugin).

sensors_readoutA

All lm-sensors readings as structured JSON (sensors -j).

storage_summaryA

Per-mount usage for the OS + data disks (df): device, mount, fstype, total/used/avail bytes, and percent. Skips tmpfs/overlay/virtual mounts.

list_shared_foldersB

OMV shared folders (name, path, device).

list_smb_sharesB

Configured SMB/CIFS shares.

omv_rpcA

Generic OMV RPC passthrough: omv-rpc -u admin <service> <method> <params>. UNRESTRICTED -- can call mutating methods too. Discover methods by grepping /usr/share/openmediavault/engined/rpc/*.inc on the host.

list_containersA

Docker containers with names/status/image (docker ps; include_all adds stopped).

container_statsA

Live per-container CPU%, memory, net/block I/O (docker stats --no-stream).

container_inspectA

Full docker inspect for one container (config, mounts, network, state).

list_imagesB

Docker images (repo, tag, id, size).

list_volumesB

Docker volumes (name, driver, mountpoint).

list_networksC

Docker networks (id, name, driver, scope).

docker_system_dfA

Disk usage + reclaimable space by images/containers/volumes/build cache (docker system df).

container_logsA

Last tail lines of a container's logs.

restart_containerA

Restart a single container (seconds of downtime).

start_containerB

Start a stopped container.

stop_containerA

Stop a running container (downtime until restarted). Requires confirm=True.

docker_execA

Run a shell command inside a container as its user. UNRESTRICTED -- no allow/deny-list. Returns {stdout, stderr, exit_code}.

docker_pruneA

Reclaim space by removing stopped containers, dangling images, unused networks and build cache (docker system prune -f). Set volumes=True to also drop anonymous volumes (DELETES their data). Requires confirm=True.

list_stacksA

Portainer stacks (id, name, status).

get_stack_composeC

The full compose file for a Portainer stack.

start_stackA

Start a stopped stack (brings its containers up).

stop_stackA

Stop a running stack (takes all its containers down). Requires confirm=True.

restart_stackA

Stop then start a stack (downtime during the cycle). Requires confirm=True.

update_stackA

Redeploy a stack with the given compose YAML. DESTRUCTIVE: recreates containers (brief downtime). Requires confirm=True. Existing Env is preserved automatically.

list_usersC

Non-system OMV users.

list_groupsC

Non-system OMV groups.

Prompts

Interactive templates invoked by user choice

NameDescription
diagnose_storage_health
triage_containers
whats_using_space
audit_shares_and_permissions

Resources

Contextual data attached and managed by the client

NameDescription
System infoLive host/OMV info (hostname, version, kernel, cpu, memory, uptime).
Storage overviewPer-mount usage for the OS + data disks.
Health snapshotComposite: SMART overall, disk temps, CPU temp, filesystem usage.
Portainer stacksPortainer stacks (id, name, status).

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/vnaveenb/openmediavault-mcp-ssh'

If you have feedback or need assistance with the MCP directory API, please join our Discord server