RunAPI Z Image MCP server for image generation: create tasks, poll results, and check pricing across 1 model from Claude Code, Codex, Cursor, and VS Code.
Two tools with basic schemas and descriptions, but significant gaps in parameter documentation and error handling guidance. get_task has optional parameters with minimal context; check_pricing lacks clarity on defaults and return structure. No error recovery hints, no output schema documentation, and descriptions are generic. Tool names follow verb_noun convention but descriptions don't explain WHEN to use each tool or what happens on failure. Parameters lack type constraints (enums, ranges) and dependency documentation.
Look up RunAPI pricing for the z-image model line.
Fetch the current status and latest result payload for a z-image task.
Parameter descriptions lack actionable constraints. 'action' param in both tools has no guidance on valid values, format, or when to omit. LLMs cannot infer endpoint names from vague descriptions.
No output schema documented. Callers don't know what fields to expect from get_task (task status structure?) or check_pricing (pricing format, currency, units?). Downstream tool chaining impossible.
Error handling provides no recovery guidance. No mention of what happens if task_id is invalid, action doesn't exist, or pricing lookup fails. LLM cannot self-correct.
Descriptions are generic and under 100 chars. 'Fetch the current status...' doesn't explain WHEN to call get_task vs creating a new task, or what 'latest result payload' contains. Ambiguous for LLM selection.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 51 | 2026-07-28+ | v2 |
Optional parameters lack defaults or dependency hints. get_task's 'action' is optional but description says 'Defaults to the line's only asynchronous endpoint', unclear if this applies when multiple endpoints exist.