Wiro MCP Server

Official

Overview Schema Source Related Servers Discussions Admin

Run a Wiro model

run_model

Run any AI model on Wiro for generation, editing, or analysis across image, video, text, audio, and 3D. Provide the model slug and parameters to execute a task and return its output.

Instructions

Run any AI model on Wiro. Supports image, video, text, audio, 3D, and more. Call get_model_schema first. With wait=true this performs a bounded wait; when the response contains nextAction.tool = "wait_for_task", call that tool with the exact arguments returned. Do not resubmit the original request. A completed tool-call turn instead returns a run_model continuation template; execute its calls, fill its toolOutputs, and invoke it once. When the task completes, present every returned media resource in the user-facing response instead of reporting only task metadata.

Input Schema

TableJSON Schema

Name	Required	Description
`wait`	No	If true, poll until completion and return the result. If false, return the task identifiers immediately.
`model`	Yes	Model slug in "owner/model" format, e.g. "openai/sora-2", "google/nano-banana-pro"
`params`	Yes	Model-specific parameters as key-value pairs. Use get_model_schema to discover available parameters. Pass json and json-array parameters as structured JSON values in this same object. Continue a completed turn with previousTaskToken: add toolOutputs rows with call_id and output for tool results, or provide exactly one new prompt or non-empty messages value for a stateful next turn. For file parameters (fileinput, multifileinput, combinefileinput), pass URLs directly — no upload needed. For combinefileinput, pass an array of URLs.
`timeout_seconds`	No	Maximum seconds to wait when wait=true. The 45-second default is safe for clients with a 60-second tool timeout.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`task`	Yes
`error`	No
`state`	Yes
`outputs`	Yes
`response`	No
`nextAction`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed4 schema fields changedv1.3.0Aug 29, 2026

changedInput schema / properties / params / description

Previous value: -"Model-specific parameters as key-value pairs. Use get_model_schema to discover available parameters. For file parameters (fileinput, multifileinput, combinefileinput), pass URLs directly — no upload needed. For combinefileinput, pass an array of URLs."New value: +"Model-specific parameters as key-value pairs. Use get_model_schema to discover available parameters. Pass json and json-array parameters as structured JSON values in this same object. Continue a completed turn with previousTaskToken: add toolOutputs rows with call_id and output for tool results, or provide exactly one new prompt or non-empty messages value for a stateful next turn. For file parameters (fileinput, multifileinput, combinefileinput), pass URLs directly — no upload needed. For combinefileinput, pass an array of URLs."

addedOutput schema / properties / outputs / items / properties / finishreason

Added value: +{
+  "enum": [
+    "stop",
+    "tool_calls",
+    "length",
+    "content_filter",
+    "error"
+  ],
+  "type": "string"
+}

addedOutput schema / properties / outputs / items / properties / segments

Added value: +{
+  "items": {
+    "anyOf": [
+      {
+        "additionalProperties": false,
+        "properties": {
+          "text": {
+            "type": "string"
+          },
+          "type": {
+            "enum": [
+              "thinking",
+              "answer"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "type",
+          "text"
+        ],
+        "type": "object"
+      },
+      {
+        "additionalProperties": false,
+        "properties": {
+          "arguments": {
+            "type": "string"
+          },
+          "call_id": {
+            "type": "string"
+          },
+          "id": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "status": {
+            "enum": [
+              "in_progress",
+              "completed",
+              "incomplete"
+            ],
+            "type": "string"
+          },
+          "type": {
+            "const": "function_call",
+            "type": "string"
+          }
+        },
+        "required": [
+          "type",
+          "id",
+          "call_id",
+          "name",
+          "arguments",
+          "status"
+        ],
+        "type": "object"
+      },
+      {
+        "additionalProperties": false,
+        "properties": {
+          "call_id": {
+            "type": "string"
+          },
+          "id": {
+            "type": "string"
+          },
+          "input": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "status": {
+            "$ref": "#/properties/outputs/items/properties/segments/items/anyOf/1/properties/status"
+          },
+          "type": {
+            "const": "custom_tool_call",
+            "type": "string"
+          }
+        },
+        "required": [
+          "type",
+          "id",
+          "call_id",
+          "name",
+          "input",
+          "status"
+        ],
+        "type": "object"
+      }
+    ]
+  },
+  "type": "array"
+}

addedOutput schema / properties / outputs / items / properties / usage

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "input_tokens": {
+      "maximum": 1000000000000000,
+      "minimum": 0,
+      "type": "integer"
+    },
+    "input_tokens_details": {
+      "additionalProperties": false,
+      "properties": {
+        "audio_tokens": {
+          "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+        },
+        "cache_write_1h_tokens": {
+          "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+        },
+        "cache_write_5m_tokens": {
+          "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+        },
+        "cache_write_tokens": {
+          "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+        },
+        "cached_tokens": {
+          "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+        },
+        "image_tokens": {
+          "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+        },
+        "text_tokens": {
+          "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+        },
+        "video_tokens": {
+          "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+        }
+      },
+      "type": "object"
+    },
+    "output_tokens": {
+      "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+    },
+    "output_tokens_details": {
+      "additionalProperties": false,
+      "properties": {
+        "accepted_prediction_tokens": {
+          "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+        },
+        "audio_tokens": {
+          "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+        },
+        "image_tokens": {
+          "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+        },
+        "reasoning_tokens": {
+          "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+        },
+        "rejected_prediction_tokens": {
+          "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+        },
+        "text_tokens": {
+          "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+        },
+        "video_tokens": {
+          "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+        }
+      },
+      "type": "object"
+    },
+    "server_tool_use": {
+      "additionalProperties": false,
+      "properties": {
+        "bash_code_execution_requests": {
+          "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+        },
+        "code_execution_requests": {
+          "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+        },
+        "computer_use_requests": {
+          "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+        },
+        "file_search_requests": {
+          "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+        },
+        "image_generation_requests": {
+          "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+        },
+        "text_editor_code_execution_requests": {
+          "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+        },
+        "web_fetch_requests": {
+          "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+        },
+        "web_search_requests": {
+          "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+        }
+      },
+      "type": "object"
+    },
+    "total_tokens": {
+      "$ref": "#/properties/outputs/items/properties/usage/properties/input_tokens"
+    }
+  },
+  "required": [
+    "input_tokens",
+    "output_tokens",
+    "total_tokens"
+  ],
+  "type": "object"
+}

Changed2 schema fields changedv1.2.3Aug 25, 2026

changedInput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

changedOutput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Changed4 schema fields changedv1.2.1Aug 2, 2026

changedInput schema / properties / timeout_seconds / default
```
Previous value: -120New value: +45
```

changedInput schema / properties / timeout_seconds / description

Previous value: -"Max seconds to wait for completion (only when wait=true)"New value: +"Maximum seconds to wait when wait=true. The 45-second default is safe for clients with a 60-second tool timeout."

changedInput schema / properties / wait / description

Previous value: -"If true, poll until completion and return result. If false, return task token immediately."New value: +"If true, poll until completion and return the result. If false, return the task identifiers immediately."

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "error": {
+      "type": "string"
+    },
+    "nextAction": {
+      "additionalProperties": false,
+      "properties": {
+        "arguments": {
+          "additionalProperties": {},
+          "type": "object"
+        },
+        "reason": {
+          "type": "string"
+        },
+        "tool": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "tool",
+        "arguments",
+        "reason"
+      ],
+      "type": "object"
+    },
+    "outputs": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "kind": {
+            "enum": [
+              "image",
+              "video",
+              "audio",
+              "text",
+              "file"
+            ],
+            "type": "string"
+          },
+          "mimeType": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "sizeBytes": {
+            "anyOf": [
+              {
+                "minimum": 0,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "text": {
+            "type": "string"
+          },
+          "url": {
+            "format": "uri",
+            "type": "string"
+          }
+        },
+        "required": [
+          "mimeType",
+          "sizeBytes",
+          "kind"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "response": {
+      "type": "string"
+    },
+    "state": {
+      "enum": [
+        "submitted",
+        "running",
+        "completed",
+        "failed",
+        "cancelled"
+      ],
+      "type": "string"
+    },
+    "task": {
+      "additionalProperties": false,
+      "properties": {
+        "costUsd": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "durationSeconds": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "exitCode": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "model": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string"
+        },
+        "token": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    }
+  },
+  "required": [
+    "state",
+    "task",
+    "outputs"
+  ],
+  "type": "object"
+}

First observedv1.1.4Jun 11, 2026

TDQS

A5/5.0

Behavior5/5

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

Despite annotations already indicating non-readonly and non-idempotent behavior, the description adds crucial operational context: bounded waits, continuation mechanics, file parameter URL handling, and the requirement to render media results to the user. These details go well beyond the structured annotation fields and materially shape how the agent must behave.

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?

The description is dense but every sentence carries operational weight. It front-loads the core action, then walks through the async and continuation flows in a logical order without repeating schema content or including filler.

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

Completeness5/5

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

For a tool this complex—with async behavior, continuations, file params, and a rich output schema—the description covers the essential call flow, edge cases, and user-facing obligations. The presence of an output schema and sibling tools further supports a complete context without needing to restate return structures.

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

Parameters5/5

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

Schema coverage is 100% and each parameter already has a description, but the tool description adds high-value semantics: how to pass JSON values, how to continue a completed turn with toolOutputs or messages, and how to handle file input types including combinefileinput arrays. This meaningfully supplements the schema.

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

Purpose5/5

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

The description opens with a crisp verb+resource statement: 'Run any AI model on Wiro' and enumerates supported modalities. It clearly identifies the tool as the execution entry point, and sibling tools like get_model_schema and wait_for_task are contextually distinct without needing to be named.

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

Usage Guidelines5/5

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

The description gives explicit procedural guidance: call get_model_schema first, use wait=true for bounded polling, delegate to wait_for_task when nextAction appears, do not resubmit, and complete continuation templates. It also distinguishes the completed-tool-call flow from the initial invocation, which is essential for correct use.

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

Deploy Server