RunAPI Flux 2 MCP server for image generation: create tasks, poll results, and check pricing across 6 model variants from Claude Code, Codex, Cursor, and VS Code.
Server has 4 tools with mixed quality. Two static tools (get_task, check_pricing) have reasonable descriptions but lack detailed parameter documentation. Two dynamic tools (dynamic_asynchronous_endpoints, dynamic_synchronous_endpoints) are problematic: their schemas are generated at runtime from contract.json, making them invisible in static analysis. Parameter descriptions are minimal or absent. No error handling guidance. No tool annotations. Output schemas undocumented. Naming is acceptable but descriptions fall short of LLM-optimization standards (target 50-200 chars; most are 80-120 chars). This is a D-grade server with significant gaps in schema completeness and parameter clarity.
Look up RunAPI pricing for the flux-2 model line.
Dynamically registered asynchronous endpoints from contract.json for creating Flux 2 tasks. Each endpoint creates a task and returns a task id, status, and output URLs.
Dynamically registered synchronous endpoints from contract.json for running Flux 2 operations. Each endpoint runs a synchronous operation and returns the operation result.
Fetch the current status and latest result payload for a flux-2 task.
Dynamic tools lack visible input schemas. Schemas are generated at runtime from contract.json, making them invisible to static analysis and MCP clients. No schema documentation in code.
Parameter descriptions are minimal. 'action' param in get_task and check_pricing lacks detail on valid values, format, or when to use. No enum constraints visible.
No output schema documentation. Tools return jsonText() responses but no structured schema is declared. LLMs cannot predict response fields for downstream chaining.
Error handling lacks recovery guidance. Errors return friendlyError() or generic messages without actionable next steps (e.g., 'Try search_users() first').
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 48 | 2026-07-28+ | v2 |
No tool annotations. Tools lack readOnlyHint, destructiveHint, or idempotentHint metadata. Agents cannot infer safety properties.