Images

Back to the MCP tool reference.

push_image

Push a local Docker image to one exact Apolo repository and tag.

Operation type: Write

Annotations: read-only false, destructive false, idempotent false, open-world true

Input schema:

{
  "properties": {
    "cluster": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cluster"
    },
    "local_image": {
      "title": "Local Image",
      "type": "string"
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Org"
    },
    "project": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Project"
    },
    "repository": {
      "title": "Repository",
      "type": "string"
    },
    "tag": {
      "title": "Tag",
      "type": "string"
    },
    "timeout_seconds": {
      "default": 1800,
      "title": "Timeout Seconds",
      "type": "number"
    }
  },
  "required": [
    "local_image",
    "repository",
    "tag"
  ],
  "title": "push_imageArguments",
  "type": "object"
}

Output schema:

{
  "additionalProperties": true,
  "title": "push_imageDictOutput",
  "type": "object"
}

pull_image

Pull one exact Apolo image into the MCP host's local Docker engine.

Operation type: Write

Annotations: read-only false, destructive false, idempotent false, open-world true

Input schema:

{
  "properties": {
    "cluster": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cluster"
    },
    "local_image": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Local Image"
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Org"
    },
    "project": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Project"
    },
    "repository": {
      "title": "Repository",
      "type": "string"
    },
    "tag": {
      "title": "Tag",
      "type": "string"
    },
    "timeout_seconds": {
      "default": 1800,
      "title": "Timeout Seconds",
      "type": "number"
    }
  },
  "required": [
    "repository",
    "tag"
  ],
  "title": "pull_imageArguments",
  "type": "object"
}

Output schema:

{
  "additionalProperties": true,
  "title": "pull_imageDictOutput",
  "type": "object"
}

list_image_repositories

List repositories in one exact context under a strict output bound.

Operation type: Read-only

Annotations: read-only true, destructive false, idempotent true, open-world true

Input schema:

{
  "properties": {
    "cluster": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cluster"
    },
    "limit": {
      "default": 50,
      "title": "Limit",
      "type": "integer"
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Org"
    },
    "project": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Project"
    }
  },
  "title": "list_image_repositoriesArguments",
  "type": "object"
}

Output schema:

{
  "additionalProperties": true,
  "title": "list_image_repositoriesDictOutput",
  "type": "object"
}

list_image_tags

List tags for one exact repository under a strict output bound.

Operation type: Read-only

Annotations: read-only true, destructive false, idempotent true, open-world true

Input schema:

{
  "properties": {
    "cluster": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cluster"
    },
    "limit": {
      "default": 50,
      "title": "Limit",
      "type": "integer"
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Org"
    },
    "project": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Project"
    },
    "repository": {
      "title": "Repository",
      "type": "string"
    }
  },
  "required": [
    "repository"
  ],
  "title": "list_image_tagsArguments",
  "type": "object"
}

Output schema:

{
  "additionalProperties": true,
  "title": "list_image_tagsDictOutput",
  "type": "object"
}

inspect_image

Inspect exact tag metadata: digest and aggregate layer size only.

Operation type: Read-only

Annotations: read-only true, destructive false, idempotent true, open-world true

Input schema:

{
  "properties": {
    "cluster": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cluster"
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Org"
    },
    "project": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Project"
    },
    "repository": {
      "title": "Repository",
      "type": "string"
    },
    "tag": {
      "title": "Tag",
      "type": "string"
    }
  },
  "required": [
    "repository",
    "tag"
  ],
  "title": "inspect_imageArguments",
  "type": "object"
}

Output schema:

{
  "additionalProperties": true,
  "title": "inspect_imageDictOutput",
  "type": "object"
}

remove_image_tag

Remove one exact image tag without requesting digest deletion. The operation passes the tag reference to the registry. Tags that happen to share a manifest digest are not separate deletion targets.

Operation type: Destructive write

Annotations: read-only false, destructive true, idempotent true, open-world true

Input schema:

{
  "properties": {
    "cluster": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cluster"
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Org"
    },
    "project": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Project"
    },
    "repository": {
      "title": "Repository",
      "type": "string"
    },
    "tag": {
      "title": "Tag",
      "type": "string"
    }
  },
  "required": [
    "repository",
    "tag"
  ],
  "title": "remove_image_tagArguments",
  "type": "object"
}

Output schema:

{
  "additionalProperties": true,
  "title": "remove_image_tagDictOutput",
  "type": "object"
}