Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_webmin_servers | List all configured Webmin servers with their aliases and connection info. Shows which server is the default. |
| test_server_connection | Test connectivity to a specific Webmin server. Returns version and hostname if successful. |
| get_webmin_version | Get the version of the connected Webmin server. Returns the version string and hostname. |
| get_system_info | Get comprehensive system information including OS, kernel, CPU, memory, disk usage, and update status. This is a good starting point for understanding system state. |
| list_services | List all system services (systemd units or init scripts). Returns service names. Use get_service_status to check if a specific service is running. |
| get_service_status | Get the status of a specific system service. Returns whether the service is running or stopped. |
| list_users | List all system users. Returns both regular users (UID >= 1000) and system users separately, with details like home directory and shell. |
| get_disk_usage | Get disk usage information for all mounted filesystems. Shows total, used, and free space, plus inode usage. |
| get_memory_usage | Get memory usage information. Shows total, used, and free memory in KB, MB, and GB, plus buffer and cache usage. |
| list_cron_jobs | List all scheduled cron jobs. Shows the schedule, command, user, and whether each job is active. |
| get_network_info | Get network configuration including all interfaces (with IP, MAC, speed), routing table, and default gateway. |
| restart_service | Restart a system service. The service will be stopped and then started again. Some critical services (ssh, webmin) may be blocked in safe mode. |
| start_service | Start a stopped system service. If the service is already running, this is a no-op. |
| stop_service | Stop a running system service. Critical services (ssh, webmin, systemd services) are blocked to prevent system lockout. |
| enable_service | Enable a service to start automatically at system boot. |
| disable_service | Disable a service from starting automatically at system boot. Critical services are blocked to prevent boot failures. |
| create_cron_job | Create a new scheduled cron job. Specify the command to run and the schedule using cron syntax (minutes, hours, days, months, weekdays). Use '' for 'every' (e.g., '/5' for every 5 minutes). |
| edit_cron_job | Edit an existing cron job. Use list_cron_jobs to find the job index. Only specify the fields you want to change. |
| delete_cron_job | Delete a cron job. This is a dangerous operation and is blocked in safe mode. Use list_cron_jobs to find the job index. |
| list_groups | List all system groups. Returns both regular groups (GID >= 1000) and system groups separately, with member information. |
| create_user | Create a new system user. This is a dangerous operation and is blocked in safe mode. |
| delete_user | Delete a system user. This is a dangerous operation and is blocked in safe mode. Critical system users cannot be deleted. |
| modify_user | Modify an existing system user. Only specify fields you want to change. |
| change_password | Change a user's password. This is a dangerous operation and is blocked in safe mode. |
| get_package_info | Get detailed information about an installed package including version, description, maintainer, and install date. |
| list_available_updates | List all available package updates including security updates. Shows current and new versions for each package. |
| get_package_count | Get the total count of installed packages on the system. |
| read_file | Read the contents of a file from the remote system. Can return content as a string or as an array of lines. |
| write_file | Write content to a file. This is a dangerous operation. In safe mode, only writes to /tmp and /var/tmp are allowed. System directories (/etc, /bin, /usr, etc.) are always blocked. |
| delete_file | Delete a file or empty directory. This is a dangerous operation. In safe mode, only deletes in /tmp and /var/tmp are allowed. System directories are always protected. |
| copy_file | Copy a file to a new location. In safe mode, destination must be in /tmp or /var/tmp. |
| rename_file | Rename or move a file. In safe mode, both source and destination must be in /tmp or /var/tmp. |
| create_directory | Create a new directory. In safe mode, only directories in /tmp or /var/tmp can be created. |
| list_processes | List all running processes on the system. Shows PID, user, CPU usage, memory, and command for each process. |
| list_mounts | List all mounted filesystems. Shows mount point, device, filesystem type, and mount options. |
| list_disks | List all physical disks with SMART capability. Shows device path, model, serial number, capacity, and whether SMART is enabled. |
| get_disk_health | Get SMART health status for a specific disk. Returns overall health, temperature, power-on hours, SMART attributes, and any errors or warnings. |
| list_volume_groups | List all LVM volume groups. Shows name, total size, free space, physical volume count, and logical volume count for each VG. |
| list_logical_volumes | List all LVM logical volumes. Shows name, size, volume group, device path, and mount point for each LV. |
| get_system_time | Get the current system time and timezone configuration. |
| list_runlevels | List system runlevels and their descriptions. |
| get_ssh_config | Get SSH server (sshd) configuration settings including port, authentication methods, and security options. |
| list_webmin_logs | List Webmin action/audit logs. Shows recent actions performed through Webmin including user, module, and action details. |
| list_backups | List Webmin configuration backups. Shows available backups that can be restored. |
| list_fail2ban_jails | List all Fail2ban jails and their status. Shows which jails are enabled and their current ban counts. |
| get_fail2ban_status | Get Fail2ban status for a specific jail or overall. Returns currently banned IPs and ban counts. |
| list_banned_ips | List all currently banned IP addresses from Fail2ban. |
| list_mysql_databases | List all MySQL databases. Separates user databases from system databases (information_schema, mysql, etc.). |
| list_mysql_users | List all MySQL users and their host permissions. |
| get_mysql_status | Get MySQL server status including version, uptime, connections, and query statistics. |
| list_webmin_users | List all Webmin user accounts (NOT system users). Shows usernames and which modules each user can access. |
| get_webmin_user | Get detailed permissions for a specific Webmin user account. Shows which modules the user can access. |
| list_webmin_modules | List all available Webmin modules that can be assigned to users. |
| create_webmin_user | Create a new Webmin user account. This is a dangerous operation and is blocked in safe mode. |
| modify_webmin_user | Modify a Webmin user's permissions or password. This is a dangerous operation and is blocked in safe mode. Cannot demote the last superuser account. |
| delete_webmin_user | Delete a Webmin user account. This is a dangerous operation and is blocked in safe mode. The last superuser account cannot be deleted regardless of safe mode. |
| list_quota_filesystems | List filesystems with disk quota support. Shows which filesystems have quotas enabled and their status. |
| list_user_quotas | List all user quotas on a specific filesystem. Shows disk usage, soft/hard limits for blocks and files. |
| get_user_quota | Get quota limits and usage for a specific user on a filesystem. |
| get_group_quota | Get quota limits and usage for a specific group on a filesystem. |
| set_user_quota | Set disk quota limits for a user on a filesystem. This is a dangerous operation and is blocked in safe mode. Set limits to 0 for unlimited. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |