Capabilities

A capability is a named, installable bundle of the tools an agent needs to do one kind of job — an MCP server (or several), the skills that drive it, the external programs it requires, and the entitlements it asks for. Install one onto an agent in a single command instead of wiring each piece by hand.

mur capability list                       # what's available
mur capability show media                 # inspect a capability's contents
mur capability install media --agent coach  # wire it onto the "coach" agent
mur capability remove media --agent coach   # reverse the wiring

Installing materializes the capability into the agent's profile: its MCP server is added, its requires_programs are recorded (and checked), the suggested entitlements are requested (you consent, nothing is granted silently), and requires_capabilities records the dependency. The agent picks it up on its next restart.

The media capability

The first built-in capability is media — watch and analyze video with MUR:

• MCP server: mur-mcp-server (VLC control + local-model scene/video analysis)
• Skills: video-analyze, watch-together, scene-explain, vlc-control
• Requires: VLC (playback) and yt-dlp (YouTube captions)
• Entitlements: loopback network (VLC's HTTP control + the local model)

mur capability install media --agent coach
mur agent doctor coach        # surfaces a missing VLC / yt-dlp
mur agent install-deps coach  # install the curated program requirements

The bundled skills are shipped with MUR and inject store-wide, so they cost nothing to "deliver" — only the MCP wiring and program requirements are written onto the agent.

Governed by design

Capabilities install under the same governance as every other MUR unit:

• Never-shadow — a capability's (or an imported plugin's) skill can never silently override a MUR built-in. mur skill doctor reports any agent-local copy that drifts from the built-in, and mur skill doctor --fix --apply de-pins the redundant ones so the agent always uses the current shipped version.
• Pin-preserving — re-installing a capability keeps any MCP binary pin you added with mur agent mcp pin; remove only removes an MCP server that still matches the capability's definition, so a server you've customized is left in place. A pinned binary that changes underneath the agent stops it from starting — see MCP Binary Pinning.
• Conservative removal — remove drops the MCP wiring and the requires_capabilities entry, but keeps entitlements and program requirements (another capability or your own config may rely on them) and tells you exactly which entitlements it kept and how to revoke them.

Related

• mur skill doctor — health-check and de-pin an agent's skills.
• mur agent addon import / mur agent addon reimport — import a Claude plugin as a governed add-on (never-shadow, content-hash pinned, re-verified on reimport).
• mur official list / mur official install — browse and install official agents and fleets from the app.mur.run catalog.