Iminify

Get an image

get_image

Read-onlyIdempotent

One image with its status, sizes and savings. Poll this, a few seconds apart, until the status is completed, already-optimized, failed or cancelled. Once finished, optimized.download_url downloads the result and original.download_url the file as it was sent; both addresses work without a token and expire after an hour, so ask again for fresh ones.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`id`	Yes	The image's id.

Output Schema

TableJSON Schema

Name	Required	Description
`id`	No	The image's id.
`hint`	No	What to do next, when the status alone does not say.
`name`	No	The name the optimized copy downloads under.
`status`	No
`scan_id`	No	The page scan that found it, if one did.
`alt_text`	No	The AI alt text, or null when none was asked for.
`original`	No
`settings`	No
`optimized`	No	Null until the image has finished.
`share_url`	No	Its public page, once shared.
`created_at`	No
`source_url`	No	The address it was fetched from: its address on the scanned page, or the url it was sent as. Null for a file.
`updated_at`	No
`saved_bytes`	No	Negative when the optimized copy is larger.
`saved_percent`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 8, 2026

addedOutput schema / 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"
+  ]
+}

Changed1 schema field changedOct 7, 2026

addedOutput schema / 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"
+  ]
+}

Changed2 schema fields changedSep 26, 2026

addedOutput schema / 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 / 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": {
+    "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"
+      ]
+    }
+  },
+  "type": "object"
+}

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?