bazzite-mcp
Provides tools and knowledge for managing Flatpak packages, including installation, updates, and troubleshooting on Bazzite systems.
Provides tools and knowledge for managing Homebrew packages, including installation, updates, and troubleshooting on Bazzite systems.
Provides tools for interacting with Steam library, generating gaming reports, and managing MangoHud settings on Bazzite systems.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@bazzite-mcp check system health and status"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
bazzite-mcp
MCP server plus local skill content for agents operating a Bazzite host.
Use it when the agent needs:
Bazzite-native knowledge and install choices
Live host state and guarded mutations
Desktop awareness: screenshots, windows, input, accessibility
Built-in Bazzite knowledge resources and official doc pointers
src/bazzite_mcp/ is the capability layer.
skills/bazzite-operator/ is the workflow/policy layer.
Install
Requires Python 3.11+ and uv.
uv tool install bazzite-mcp
bazzite-mcp --versionFrom source:
git clone https://github.com/rolandmarg/bazzite-mcp.git
cd bazzite-mcp
uv syncRelated MCP server: coolify-mcp
MCP Setup
Claude Code:
{
"mcpServers": {
"bazzite": {
"command": "bazzite-mcp"
}
}
}Any stdio-capable MCP client can use the same command.
From a source checkout:
uv run --directory /path/to/bazzite-mcp python -m bazzite_mcpCore MCP
The server exposes host capabilities for:
packages,
ujust, updates, audit, rollbacksystem info, storage checks, snapshots, health checks
settings: theme, audio, power, display, gsettings
services, firewall, networking
containers and VMs
desktop control: screenshots, windows, AT-SPI actions, keyboard, mouse
gaming: Steam library, reports, MangoHud settings
lightweight docs/knowledge lookup and official source pointers
Resources:
bazzite://system/overviewbazzite://knowledge/indexbazzite://knowledge/install-policybazzite://knowledge/troubleshootingbazzite://server/info
Skills
The repo includes skills/bazzite-operator/.
Use the skill for:
choosing the right Bazzite install path:
ujust, Flatpak, Homebrew, Distrobox, VM, rpm-ostreetroubleshooting Bazzite-specific desktop, service, and update issues
turning raw MCP output into Bazzite-aware recommendations
Use MCP tools for live state and host changes. Use the skill for policy and workflow.
Utilities
Clean local data:
bazzite-mcp-cleanupRemove config too:
bazzite-mcp-cleanup --include-configLicense
Available Tools
24 toolsauditC
Query audit log or rollback a previous action.
Inputs: action (required), action_id, tool, search, +1 more. Returns: result
display_configB
Query or change display resolution, refresh rate, or scaling.
Inputs: action (required), output, resolution, refresh, +1 more. Returns: result
docsC
Search local Bazzite knowledge or return official changelog sources.
Inputs: action (required), query, version, count, +1 more. Returns: result
gamingC
Steam library, ProtonDB/PCGamingWiki reports, and per-game settings.
Inputs: action (required), app_id, name_filter, mangohud, +1 more. Returns: result
gsettingsC
Read or write a gsettings value.
Inputs: action (required), schema, key, value. Returns: result
interactC
Perform an action on a UI element via AT-SPI accessibility API.
Inputs: window (required), element (required), action. Returns: result
manage_distroboxC
Manage distrobox containers: create, list, enter, stop, remove, exec, or export apps.
Inputs: action (required), name, image, command, +1 more. Returns: result
manage_firewallC
Manage firewalld rules with audit logging and reload.
Inputs: action (required), port, service. Returns: result
manage_networkC
Manage NetworkManager connections and view network status.
Inputs: action (required), name, properties. Returns: result
manage_podmanC
Run podman container operations with dangerous flag blocking.
Inputs: action (required), container, image, command. Returns: result
manage_quadletB
Manage Quadlet units for persistent containerized services.
Inputs: action (required), name, image. Returns: result
manage_serviceB
Manage systemd services: start, stop, restart, enable, disable, status, or list.
Inputs: name, action, user, state. Returns: result
manage_snapshotsB
Manage btrfs home snapshots: list, status, or diff against current state.
Inputs: action (required), snapshot_id. Returns: result
manage_vmC
Manage VMs on Bazzite with hardened default profile support.
Inputs: action (required), name, iso_path, snapshot, +5 more. Returns: result
manage_windowsC
List, activate, or inspect windows via KWin/AT-SPI.
Inputs: action (required), window, depth. Returns: result
packagesC
Install, remove, search, list, or update packages across supported backends.
Inputs: action (required), package, method, source. Returns: result
quick_settingC
Switch theme, audio output, or power profile.
Inputs: setting (required), mode, device, profile. Returns: result
screenshotA
Capture a screenshot and return the image directly. This is a single-call tool — do NOT list windows or gather system info first.
Call with no arguments for a full desktop capture (all monitors). For a specific window: target='window', window='' — fuzzy-matches title or window class, activates the window, and captures it. No need to call manage_windows first. For the currently active window: target='window' with no window argument.
Inputs: target, window.
send_inputC
Send keyboard or mouse input via ydotool.
For mouse mode with coordinates from a screenshot, pass the metadata JSON string from the screenshot response as screenshot_meta.
Inputs: mode (required), keys, key, action, +5 more. Returns: result
set_textC
Set text content of an editable field via AT-SPI.
Inputs: window (required), element (required), text (required). Returns: result
storage_diagnosticsA
Capture full storage breakdown with optimization suggestions.
Inputs: no named parameters. Returns: result
system_doctorA
Run security and health checks with PASS, WARN, and FAIL assessments.
Inputs: no named parameters. Returns: result
system_infoA
Get system info: basic summary or full hardware report.
Inputs: detail. Returns: result
ujustC
Run, list, or inspect ujust commands.
Inputs: action (required), command, filter. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 24 tools
Each tool targets a distinct resource or action, with clear boundaries even among similar functions like manage_windows, interact, and set_text, which focus on different aspects of UI management.
Most tools follow a verb_noun pattern or use the 'manage_' prefix, though a few like 'docs', 'gsettings', and 'packages' are noun-only, introducing minor inconsistency.
With 24 tools, the set is slightly large but still scoped appropriately for a comprehensive system management server, avoiding unnecessary bulk.
The tools cover a broad range of system management tasks including networking, storage, security, containers, VMs, UI automation, and gaming, leaving few obvious gaps for the intended domain.
Maintenance
Related MCP Connectors
Secure and manage MCP servers through the Speakeasy AI Control Plane from your agent.
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
MCP server for Gainium — manage trading bots, deals, and balances via AI assistants
MCP gateway and cloud hosting for MCP servers, agents and apps like RAG, managed from your agent.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server for managing Ubuntu/Linux systems, enabling AI assistants to execute commands, manage services, files, logs, and packages via local or SSH connection.47MIT
- AlicenseBqualityBmaintenanceMCP server for managing Coolify instances, enabling control of applications, databases, services, servers, and more via natural language.13637 npmMIT

6amdev-server-mcpofficial
AlicenseBqualityDmaintenanceMCP server for managing Ubuntu servers with AI integration, enabling system monitoring, Docker control, Gitea repository management, Ollama LLM interaction, workspace file operations, and Claude Code assistant via natural language.34MIT- AlicenseBqualityBmaintenanceMCP server that exposes Podman host management as tools, allowing natural language control of containers, images, volumes, networks, and pods. Includes an administrative console with safety profiles for gated access.18MIT