Iminify

List images

list_images

Read-onlyIdempotent

The account's images, newest first: uploads, images found by page scans, and re-runs. Filter by status, by source (upload or scan) or by one scan's id. Pages of up to 100; ask for the next page while page is below last_page. For one image whose id you already have, call get_image instead.

Input Schema

TableJSON Schema

Name	Required	Description
`page`	No	The page to read, starting at 1 (the default).
`scan`	No	Only the images one page scan found, by the id scan_page returned.
`source`	No	"upload" for images that were sent, "scan" for the ones page scans found.
`status`	No	Only images with this status. queued and optimizing are still running; completed, already-optimized, failed and cancelled are finished.
`per_page`	No	Images a page, from 1 to 100. 15 by default.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`page`	No
`total`	No
`images`	No
`per_page`	No
`last_page`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 8, 2026

addedOutput schema / properties / images / items / properties / alt_text

Added value: +{
+  "description": "The AI alt text, or null when none was asked for.",
+  "properties": {
+    "language": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "status": {
+      "description": "pending: being written, a few seconds after the image is completed or already-optimized; it waits for a retry while the image is failed or cancelled. written: ready. failed: ask again with write_alt_text. skipped: the day's AI alt texts were used up.",
+      "enum": [
+        "pending",
+        "written",
+        "failed",
+        "skipped"
+      ],
+      "type": "string"
+    },
+    "suggested_name": {
+      "description": "A descriptive file name without an extension, for rename_image.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "text": {
+      "description": "One sentence for the image's alt attribute, once written.",
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "required": [
+    "status",
+    "text",
+    "language",
+    "suggested_name"
+  ],
+  "type": [
+    "object",
+    "null"
+  ]
+}

changedOutput schema / properties / images / items / required

Previous value: -[
-  "id",
-  "status",
-  "name",
-  "original",
-  "optimized",
-  "saved_bytes",
-  "saved_percent",
-  "settings",
-  "scan_id",
-  "source_url",
-  "share_url",
-  "created_at",
-  "updated_at"
-]New value: +[
+  "id",
+  "status",
+  "name",
+  "original",
+  "optimized",
+  "saved_bytes",
+  "saved_percent",
+  "settings",
+  "alt_text",
+  "scan_id",
+  "source_url",
+  "share_url",
+  "created_at",
+  "updated_at"
+]

Changed2 schema fields changedOct 7, 2026

addedOutput schema / properties / images / items / properties / source_url

Added value: +{
+  "description": "The address it was fetched from: its address on the scanned page, or the url it was sent as. Null for a file.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

changedOutput schema / properties / images / items / required

Previous value: -[
-  "id",
-  "status",
-  "name",
-  "original",
-  "optimized",
-  "saved_bytes",
-  "saved_percent",
-  "settings",
-  "scan_id",
-  "share_url",
-  "created_at",
-  "updated_at"
-]New value: +[
+  "id",
+  "status",
+  "name",
+  "original",
+  "optimized",
+  "saved_bytes",
+  "saved_percent",
+  "settings",
+  "scan_id",
+  "source_url",
+  "share_url",
+  "created_at",
+  "updated_at"
+]

Changed2 schema fields changedSep 26, 2026

addedOutput schema / properties / images / items / properties / settings / properties / format

Added value: +{
+  "description": "The format asked for, or null when none was sent. auto stays auto after the image finishes.",
+  "enum": [
+    "auto",
+    "webp",
+    "avif",
+    "png",
+    "jpg",
+    null
+  ],
+  "type": [
+    "string",
+    "null"
+  ]
+}

changedOutput schema / properties / images / items / properties / settings / required

Previous value: -[
-  "level",
-  "keep_metadata",
-  "width",
-  "height",
-  "scale"
-]New value: +[
+  "level",
+  "format",
+  "keep_metadata",
+  "width",
+  "height",
+  "scale"
+]

Changed1 schema field changedSep 24, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "properties": {
+    "images": {
+      "items": {
+        "properties": {
+          "created_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "hint": {
+            "description": "What to do next, when the status alone does not say.",
+            "type": "string"
+          },
+          "id": {
+            "description": "The image's id.",
+            "type": "string"
+          },
+          "name": {
+            "description": "The name the optimized copy downloads under.",
+            "type": "string"
+          },
+          "optimized": {
+            "description": "Null until the image has finished.",
+            "properties": {
+              "download_url": {
+                "description": "Works without a token for an hour.",
+                "type": "string"
+              },
+              "format": {
+                "type": "string"
+              },
+              "height": {
+                "type": "integer"
+              },
+              "name": {
+                "type": "string"
+              },
+              "size": {
+                "description": "Bytes.",
+                "type": "integer"
+              },
+              "width": {
+                "type": "integer"
+              }
+            },
+            "required": [
+              "name",
+              "format",
+              "size",
+              "width",
+              "height",
+              "download_url"
+            ],
+            "type": [
+              "object",
+              "null"
+            ]
+          },
+          "original": {
+            "properties": {
+              "download_url": {
+                "description": "Works without a token for an hour.",
+                "type": "string"
+              },
+              "format": {
+                "type": "string"
+              },
+              "height": {
+                "type": "integer"
+              },
+              "name": {
+                "type": "string"
+              },
+              "size": {
+                "description": "Bytes.",
+                "type": "integer"
+              },
+              "width": {
+                "type": "integer"
+              }
+            },
+            "required": [
+              "name",
+              "format",
+              "size",
+              "width",
+              "height",
+              "download_url"
+            ],
+            "type": "object"
+          },
+          "saved_bytes": {
+            "description": "Negative when the optimized copy is larger.",
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "saved_percent": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "scan_id": {
+            "description": "The page scan that found it, if one did.",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "settings": {
+            "properties": {
+              "height": {
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              },
+              "keep_metadata": {
+                "type": "boolean"
+              },
+              "level": {
+                "enum": [
+                  "none",
+                  "lossless",
+                  "ultra",
+                  "smart",
+                  null
+                ],
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "scale": {
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              },
+              "width": {
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "level",
+              "keep_metadata",
+              "width",
+              "height",
+              "scale"
+            ],
+            "type": "object"
+          },
+          "share_url": {
+            "description": "Its public page, once shared.",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "status": {
+            "enum": [
+              "queued",
+              "optimizing",
+              "completed",
+              "failed",
+              "already-optimized",
+              "cancelled"
+            ],
+            "type": "string"
+          },
+          "updated_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "id",
+          "status",
+          "name",
+          "original",
+          "optimized",
+          "saved_bytes",
+          "saved_percent",
+          "settings",
+          "scan_id",
+          "share_url",
+          "created_at",
+          "updated_at"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "last_page": {
+      "type": "integer"
+    },
+    "page": {
+      "type": "integer"
+    },
+    "per_page": {
+      "type": "integer"
+    },
+    "total": {
+      "type": "integer"
+    }
+  },
+  "type": "object"
+}

Changed4 schema fields changedSep 24, 2026

changedInput schema / properties / page / description

Previous value: -"The page to read, from 1."New value: +"The page to read, starting at 1 (the default)."

changedInput schema / properties / per_page / description

Previous value: -"Images a page. 15 by default."New value: +"Images a page, from 1 to 100. 15 by default."

changedInput schema / properties / scan / description

Previous value: -"Only the images of this page scan, by its id."New value: +"Only the images one page scan found, by the id scan_page returned."

changedInput schema / properties / status / description

Previous value: -"Only images with this status."New value: +"Only images with this status. queued and optimizing are still running; completed, already-optimized, failed and cancelled are finished."

First observedSep 24, 2026

TDQS

Score is being calculated.

All Iminify tools Inspect

Try in Browser

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?