Iminify

Get usage

get_usage

Read-onlyIdempotent

Your Iminify plan, what it allows, and how much of today's allowance is used, with when it resets. The website, the API and this server spend the same counts. On max, which is unlimited, the images and page scans a day and what is left of them are null. Check this before a large batch.

Input Schema

Name	Required	Description	Default
No arguments

Output Schema

Name	Required	Description
`plan`	No	pro and max are the paid plans; trial is the days of Pro an account gets once, as its email is verified or with the trial button on the website; it then answers free.
`usage`	No
`limits`	No
`plan_ends_at`	No	When a cancelled paid plan or a trial ends.

Schema Changelog

Changes observed during successful MCP inspections.

Changed4 schema fields changedNov 3, 2026

addedOutput schema / properties / limits / properties / files_per_day

Added value: +{
+  "description": "Files the API's upload groups make, which this server never opens. null on max, which is unlimited.",
+  "type": [
+    "integer",
+    "null"
+  ]
+}

changedOutput schema / properties / limits / required

Previous value: -[
-  "images_per_day",
-  "scans_per_day",
-  "alt_texts_per_day",
-  "images_per_scan",
-  "crawls_per_day",
-  "pages_per_crawl",
-  "monitors",
-  "max_file_size",
-  "max_megapixels",
-  "compressions_per_minute",
-  "scans_per_minute",
-  "requests_per_minute",
-  "max_batch"
-]New value: +[
+  "images_per_day",
+  "scans_per_day",
+  "alt_texts_per_day",
+  "files_per_day",
+  "images_per_scan",
+  "crawls_per_day",
+  "pages_per_crawl",
+  "monitors",
+  "max_file_size",
+  "max_megapixels",
+  "compressions_per_minute",
+  "scans_per_minute",
+  "requests_per_minute",
+  "max_batch"
+]

addedOutput schema / properties / usage / properties / files

Added value: +{
+  "description": "Files the API's upload groups made; nothing this server does spends them.",
+  "properties": {
+    "remaining": {
+      "description": "null where the daily limit is null.",
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "resets_at": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "used": {
+      "type": "integer"
+    }
+  },
+  "required": [
+    "used",
+    "remaining",
+    "resets_at"
+  ],
+  "type": "object"
+}

changedOutput schema / properties / usage / required

Previous value: -[
-  "images",
-  "scans",
-  "crawls",
-  "alt_texts"
-]New value: +[
+  "images",
+  "scans",
+  "crawls",
+  "alt_texts",
+  "files"
+]

Changed7 schema fields changedNov 2, 2026

changedOutput schema / properties / limits / properties / alt_texts_per_day / description

Previous value: -"AI alt texts. On max, the fair-use line, which stops before its images."New value: +"AI alt texts. Every plan has a number, max included."

changedOutput schema / properties / limits / properties / images_per_day / description

Previous value: -"On max, which is sold as unlimited, the fair-use line."New value: +"null on max, which is unlimited."

changedOutput schema / properties / limits / properties / scans_per_day / description

Previous value: -"On max, the fair-use line."New value: +"null on max, which is unlimited."

changedOutput schema / properties / usage / properties / alt_texts / properties / remaining / description

Previous value: -"On max, what is left of the fair-use line."New value: +"null where the daily limit is null."

changedOutput schema / properties / usage / properties / crawls / properties / remaining / description

Previous value: -"On max, what is left of the fair-use line."New value: +"null where the daily limit is null."

changedOutput schema / properties / usage / properties / images / properties / remaining / description

Previous value: -"On max, what is left of the fair-use line."New value: +"null where the daily limit is null."

changedOutput schema / properties / usage / properties / scans / properties / remaining / description

Previous value: -"On max, what is left of the fair-use line."New value: +"null where the daily limit is null."

Changed10 schema fields changedNov 2, 2026

changedOutput schema / properties / limits / properties / alt_texts_per_day / description

Previous value: -"AI alt texts. Null means no daily cap."New value: +"AI alt texts. On max, the fair-use line, which stops before its images."

changedOutput schema / properties / limits / properties / crawls_per_day / description

Previous value: -"Site crawls. 0 means the plan has none, null no daily cap."New value: +"Site crawls. 0 means the plan has none."

changedOutput schema / properties / limits / properties / images_per_day / description

Previous value: -"Null means no daily cap."New value: +"On max, which is sold as unlimited, the fair-use line."

changedOutput schema / properties / limits / properties / scans_per_day / description

Previous value: -"Null means no daily cap."New value: +"On max, the fair-use line."

changedOutput schema / properties / plan / description

Previous value: -"trial is the days of Pro an account gets once, as its email is verified or with the trial button on the website; it then answers free."New value: +"pro and max are the paid plans; trial is the days of Pro an account gets once, as its email is verified or with the trial button on the website; it then answers free."

changedOutput schema / properties / plan / enum

Previous value: -[
-  "guest",
-  "free",
-  "trial",
-  "pro"
-]New value: +[
+  "guest",
+  "free",
+  "trial",
+  "pro",
+  "max"
+]

changedOutput schema / properties / usage / properties / alt_texts / properties / remaining / description

Previous value: -"Null on a plan without a daily cap."New value: +"On max, what is left of the fair-use line."

changedOutput schema / properties / usage / properties / crawls / properties / remaining / description

Previous value: -"Null on a plan without a daily cap."New value: +"On max, what is left of the fair-use line."

changedOutput schema / properties / usage / properties / images / properties / remaining / description

Previous value: -"Null on a plan without a daily cap."New value: +"On max, what is left of the fair-use line."

changedOutput schema / properties / usage / properties / scans / properties / remaining / description

Previous value: -"Null on a plan without a daily cap."New value: +"On max, what is left of the fair-use line."

Changed9 schema fields changedOct 29, 2026

addedOutput schema / properties / limits / properties / crawls_per_day

Added value: +{
+  "description": "Site crawls. 0 means the plan has none, null no daily cap.",
+  "type": [
+    "integer",
+    "null"
+  ]
+}

addedOutput schema / properties / limits / properties / monitors

Added value: +{
+  "description": "Sites checked weekly at once. 0 means the plan has no weekly checks.",
+  "type": "integer"
+}

addedOutput schema / properties / limits / properties / pages_per_crawl

Added value: +{
+  "description": "0 means the plan has no site crawls.",
+  "type": "integer"
+}

changedOutput schema / properties / limits / required

Previous value: -[
-  "images_per_day",
-  "scans_per_day",
-  "alt_texts_per_day",
-  "images_per_scan",
-  "max_file_size",
-  "max_megapixels",
-  "compressions_per_minute",
-  "scans_per_minute",
-  "requests_per_minute",
-  "max_batch"
-]New value: +[
+  "images_per_day",
+  "scans_per_day",
+  "alt_texts_per_day",
+  "images_per_scan",
+  "crawls_per_day",
+  "pages_per_crawl",
+  "monitors",
+  "max_file_size",
+  "max_megapixels",
+  "compressions_per_minute",
+  "scans_per_minute",
+  "requests_per_minute",
+  "max_batch"
+]

addedOutput schema / properties / plan / description

Added value: +"trial is the days of Pro an account gets once, as its email is verified or with the trial button on the website; it then answers free."

changedOutput schema / properties / plan / enum

Previous value: -[
-  "guest",
-  "free",
-  "pro"
-]New value: +[
+  "guest",
+  "free",
+  "trial",
+  "pro"
+]

changedOutput schema / properties / plan_ends_at / description

Previous value: -"When a cancelled paid plan ends."New value: +"When a cancelled paid plan or a trial ends."

addedOutput schema / properties / usage / properties / crawls

Added value: +{
+  "properties": {
+    "remaining": {
+      "description": "Null on a plan without a daily cap.",
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "resets_at": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "used": {
+      "type": "integer"
+    }
+  },
+  "required": [
+    "used",
+    "remaining",
+    "resets_at"
+  ],
+  "type": "object"
+}

changedOutput schema / properties / usage / required

Previous value: -[
-  "images",
-  "scans",
-  "alt_texts"
-]New value: +[
+  "images",
+  "scans",
+  "crawls",
+  "alt_texts"
+]

Changed4 schema fields changedOct 8, 2026

addedOutput schema / properties / limits / properties / alt_texts_per_day

Added value: +{
+  "description": "AI alt texts. Null means no daily cap.",
+  "type": [
+    "integer",
+    "null"
+  ]
+}

changedOutput schema / properties / limits / required

Previous value: -[
-  "images_per_day",
-  "scans_per_day",
-  "images_per_scan",
-  "max_file_size",
-  "max_megapixels",
-  "compressions_per_minute",
-  "scans_per_minute",
-  "requests_per_minute",
-  "max_batch"
-]New value: +[
+  "images_per_day",
+  "scans_per_day",
+  "alt_texts_per_day",
+  "images_per_scan",
+  "max_file_size",
+  "max_megapixels",
+  "compressions_per_minute",
+  "scans_per_minute",
+  "requests_per_minute",
+  "max_batch"
+]

addedOutput schema / properties / usage / properties / alt_texts

Added value: +{
+  "properties": {
+    "remaining": {
+      "description": "Null on a plan without a daily cap.",
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "resets_at": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "used": {
+      "type": "integer"
+    }
+  },
+  "required": [
+    "used",
+    "remaining",
+    "resets_at"
+  ],
+  "type": "object"
+}

changedOutput schema / properties / usage / required

Previous value: -[
-  "images",
-  "scans"
-]New value: +[
+  "images",
+  "scans",
+  "alt_texts"
+]

Changed1 schema field changedSep 24, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "properties": {
+    "limits": {
+      "properties": {
+        "compressions_per_minute": {
+          "type": "integer"
+        },
+        "images_per_day": {
+          "description": "Null means no daily cap.",
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "images_per_scan": {
+          "type": "integer"
+        },
+        "max_batch": {
+          "type": "integer"
+        },
+        "max_file_size": {
+          "description": "Bytes.",
+          "type": "integer"
+        },
+        "max_megapixels": {
+          "type": "integer"
+        },
+        "requests_per_minute": {
+          "type": "integer"
+        },
+        "scans_per_day": {
+          "description": "Null means no daily cap.",
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "scans_per_minute": {
+          "type": "integer"
+        }
+      },
+      "required": [
+        "images_per_day",
+        "scans_per_day",
+        "images_per_scan",
+        "max_file_size",
+        "max_megapixels",
+        "compressions_per_minute",
+        "scans_per_minute",
+        "requests_per_minute",
+        "max_batch"
+      ],
+      "type": "object"
+    },
+    "plan": {
+      "enum": [
+        "guest",
+        "free",
+        "pro"
+      ],
+      "type": "string"
+    },
+    "plan_ends_at": {
+      "description": "When a cancelled paid plan ends.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "usage": {
+      "properties": {
+        "images": {
+          "properties": {
+            "remaining": {
+              "description": "Null on a plan without a daily cap.",
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "resets_at": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "used": {
+              "type": "integer"
+            }
+          },
+          "required": [
+            "used",
+            "remaining",
+            "resets_at"
+          ],
+          "type": "object"
+        },
+        "scans": {
+          "properties": {
+            "remaining": {
+              "description": "Null on a plan without a daily cap.",
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "resets_at": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "used": {
+              "type": "integer"
+            }
+          },
+          "required": [
+            "used",
+            "remaining",
+            "resets_at"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "images",
+        "scans"
+      ],
+      "type": "object"
+    }
+  },
+  "type": "object"
+}

First observedSep 24, 2026

TDQS

A4.1/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already establish readOnly, idempotent, closed-world and non-destructive, so the safety profile is covered. The description adds genuinely new behavior: counts are shared across the website, the API and this server, and on the 'max' unlimited plan the per-day image and page-scan figures are null rather than absent or an error. That null-handling note is exactly the kind of detail an agent cannot infer from structured fields. It stops short of saying how often counts refresh or whether partial-day data lags, so not a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Four short sentences, front-loaded with what the tool returns and ending with the actionable trigger 'Check this before a large batch'. Every sentence carries distinct information — allowance, shared-count semantics, null case, usage timing. The third sentence is grammatically tangled but still decodable and not padded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so the description is not obliged to enumerate return fields, and it correctly avoids that. It covers the one return-value edge case (nulls on unlimited plans) that would otherwise confuse an agent, plus cross-surface count sharing. The only gap is reset-timezone or caching behavior, which is minor for a zero-parameter read.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool takes no parameters and the schema is an empty object, so there is nothing for the description to disambiguate. Baseline of 4 applies; the description correctly spends no words on inputs and does not invent any.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names the specific resource set: the Iminify plan, its allowances, today's consumption, and the reset time. That is far more specific than the name 'get_usage' alone, though it reads as a noun phrase rather than a verb-plus-resource statement. An agent can immediately tell this apart from every sibling (compress_images, list_images, monitor_site, etc.), none of which report quota.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives one explicit usage condition — 'Check this before a large batch' — which is the primary scenario an agent would need it for. There are no exclusions or named alternatives, but no plausible alternative exists for quota inspection, so the guidance is effectively complete for practical selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

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?