Get the latest semantic version tag for a container image.

Use this when you KNOW the exact image path. Returns the latest stable semantic version tag for use in Dockerfiles or Kubernetes manifests.

⚠️ If you DON'T know the exact image path:

• Use search_images first to find the correct org/namespace

• Or use find_image which tries multiple registries automatically

• Check the project's GitHub repo for the correct image reference

Examples:

• nginx → nginx:1.27.3

• ghcr.io/kedacore/keda → ghcr.io/kedacore/keda:2.16.1

• bitnami/redis → bitnami/redis:7.4.2

• ghcr.io/autobrr/qui → ghcr.io/autobrr/qui:v0.3.0

List available tags for a container image.

Returns all semantic version tags for an image, sorted from newest to oldest. Useful when you need to see what versions are available or find a specific version pattern.

Can filter tags by regex pattern (e.g., '^v3\.' for v3.x versions only).

Check if a newer version of a container image is available.

Compares a current tag to the latest available version and tells you if an update is available and what type (major, minor, or patch).

Useful for auditing Dockerfiles or Kubernetes manifests to find outdated images.

Search for container images by name.

⚠️ USE THIS FIRST when you don't know the exact image path!

This searches Docker Hub and returns matching images with their full names. Use the results to find the correct org/namespace, then use find_image or get_latest_image_tag with the full path.

IMPORTANT: GitHub Container Registry (ghcr.io) has no search API. If you suspect an image is on GHCR, check the project's GitHub repo or documentation for the correct image path (usually ghcr.io/org/repo).

Examples:

• "radarr" → finds linuxserver/radarr, hotio/radarr, etc.

• "redis" → finds redis (official), bitnami/redis, etc.

• "qui" → finds qompass/qui (but won't find ghcr.io/autobrr/qui - no GHCR search)

Find an image by name, trying multiple registries and namespaces.

BEST PRACTICE: If you only have an application name (like "qui" or "radarr"):

1. First check the project's GitHub/website to find the correct image path

2. Look for org/repo pattern (e.g., "autobrr/qui" not just "qui")

3. Then call this tool with "org/repo" format

This tool will try the name on Docker Hub, GHCR, and Quay.io:

• "radarr" → tries linuxserver/radarr, bitnami/radarr, etc.

• "autobrr/qui" → tries Docker Hub first, then ghcr.io/autobrr/qui ✓

LIMITATION: Cannot discover GHCR images without knowing the org name. If searching for a GitHub project's image, use format: "orgname/reponame"

Examples:

• "nginx" → finds nginx:1.27.3 (official Docker Hub)

• "autobrr/qui" → finds ghcr.io/autobrr/qui:v0.3.0

• "linuxserver/radarr" → finds linuxserver/radarr:5.x.x