MCP Podman

List containers. Args: all_containers: Show all containers (default shows only running) filters: Filter by key/value pairs (e.g. {"name": ["myapp"]}) limit: Maximum number of containers to return Returns: List of containers with count

Get detailed information about a container. Args: name: Container name or ID Returns: Container details including config, state, and network settings

Start a stopped container. Args: name: Container name or ID Returns: Start result

Stop a running container. Args: name: Container name or ID timeout: Seconds to wait before killing (default: 10) Returns: Stop result

Restart a container. Args: name: Container name or ID timeout: Seconds to wait before killing (default: 10) Returns: Restart result

Send a signal to a container. Args: name: Container name or ID signal: Signal to send (default: SIGTERM) Returns: Kill result

Remove a container. Args: name: Container name or ID force: Force removal of running container volumes: Remove associated anonymous volumes Returns: Removal result

Get container logs. Args: name: Container name or ID tail: Number of lines from the end of the logs since: Show logs since timestamp (e.g. "2024-01-01T00:00:00Z") timestamps: Add timestamps to each log line Returns: Container log output

List processes running inside a container. Args: name: Container name or ID ps_args: Arguments to pass to ps (e.g. "aux") Returns: Process list with titles and entries

Get container resource usage statistics. Args: name: Container name or ID Returns: CPU, memory, network, and block I/O statistics

Create a new container. Args: image: Container image (e.g. "registry.access.redhat.com/ubi9/ubi:latest") name: Container name command: Command to run env: Environment variables labels: Container labels volumes: Volume mounts (format: "host_path:container_path[:options]") Returns: Created container ID and warnings

Remove all stopped containers. Returns: List of removed container IDs and reclaimed space

List images. Args: filters: Filter by key/value pairs (e.g. {"reference": ["ubi9"]}) Returns: List of images with count

Get detailed information about an image. Args: name: Image name, tag, or ID Returns: Image details including layers, config, and history

Pull an image from a registry. Args: reference: Image reference (e.g. "quay.io/crunchtools/rotv:latest") Returns: Pull result with image ID

Remove an image. Args: name: Image name, tag, or ID force: Force removal even if in use Returns: Removal result

Remove unused images. Returns: List of removed image IDs and reclaimed space

List pods. Args: filters: Filter by key/value pairs (e.g. {"name": ["mypod"]}) Returns: List of pods with count

Get detailed information about a pod. Args: name: Pod name or ID Returns: Pod details including containers and state

Start a pod and all its containers. Args: name: Pod name or ID Returns: Start result

Stop a pod and all its containers. Args: name: Pod name or ID timeout: Seconds to wait before killing (default: 10) Returns: Stop result

Restart a pod and all its containers. Args: name: Pod name or ID Returns: Restart result

Remove a pod and all its containers. Args: name: Pod name or ID force: Force removal of running pod Returns: Removal result

Create a new pod. Args: name: Pod name labels: Pod labels infra: Create an infra container (default: True) share: Namespaces to share (ipc, net, uts, pid) Returns: Created pod ID

List networks. Args: filters: Filter by key/value pairs Returns: List of networks with count

Get detailed information about a network. Args: name: Network name or ID Returns: Network details including subnets and connected containers

List volumes. Args: filters: Filter by key/value pairs Returns: List of volumes with count

Get detailed information about a volume. Args: name: Volume name Returns: Volume details including mount point and driver

List systemd units that manage Podman containers. Only shows units whose ExecStart contains /usr/bin/podman. Non-container services (sshd, firewalld, etc.) are excluded. Returns: List of Podman container service units with status

Get the status of a Podman container systemd unit. Args: unit_name: Systemd unit name (e.g. "acquacotta.crunchtools.com.service") Returns: Unit properties including ActiveState, MainPID, memory, CPU usage

Restart a Podman container systemd unit. This is the correct way to bounce containers on systems where containers are managed by systemd. Using podman restart directly would conflict with systemd's process management. Args: unit_name: Systemd unit name (e.g. "acquacotta.crunchtools.com.service") Returns: Restart confirmation

Start a Podman container systemd unit. Args: unit_name: Systemd unit name (e.g. "acquacotta.crunchtools.com.service") Returns: Start confirmation

Stop a Podman container systemd unit. Args: unit_name: Systemd unit name (e.g. "acquacotta.crunchtools.com.service") Returns: Stop confirmation

Get journal logs for a Podman container systemd unit. Args: unit_name: Systemd unit name (e.g. "acquacotta.crunchtools.com.service") lines: Number of log lines to return (default: 50) since: Show logs since timestamp (e.g. "1 hour ago", "2024-01-01") Returns: Journal log output for the unit

Get Podman system information. Returns: System details including version, storage, registries, and runtime

Get Podman disk usage. Returns: Disk usage by images, containers, and volumes