VideoGen

Upscale video

upscale_video

Create a higher-resolution copy of an existing video. Returns toolExecutionId; get_tool_execution provides status and the output video file. The source file is unchanged.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "videoFileId": "<videoFileId>"
    },
    "name": "upscale_video"
  }
}

Input Schema

Name	Required	Description	Default
`videoFileId`	Yes	Video to transform. Use fileId from upload_file, list_files, or a succeeded video-generation result.

Output Schema

Name	Required	Description
`error`	No	Error details when status is failed; otherwise null.
`status`	No	Job status: pending, running, succeeded, failed, or cancelled.
`results`	No	Generated results with download URLs when succeeded.
`toolType`	No	Tool name (e.g. GENERATE_IMAGE).
`attemptIndex`	No	Current or latest attempt index.
`toolExecutionId`	Yes	Tool execution id (vg_tool_...).
`progressPercentage`	No	Completion progress 0-100 (present after polling).

Schema Changelog

Changes observed during successful MCP inspections.

Changed33 schema fields changedNov 4, 2026

changedOutput schema / properties / error / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "code": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Machine-readable error code."
-      },
-      "internalErrorCode": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Opaque code for support."
-      },
-      "message": {
-        "description": "Human-readable error description.",
-        "type": "string"
-      },
-      "requirement": {
-        "anyOf": [
-          {
-            "additionalProperties": {},
-            "properties": {
-              "details": {
-                "additionalProperties": {
-                  "type": "string"
-                },
-                "propertyNames": {
-                  "type": "string"
-                },
-                "type": "object"
-              },
-              "type": {
-                "description": "Requirement type (e.g. purchase_add_on).",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "What is needed to resolve the error, when applicable."
-      }
-    },
-    "required": [
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "code": {
+        "description": "Machine-readable error code.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "internalErrorCode": {
+        "description": "Opaque code for support.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "message": {
+        "description": "Human-readable error description.",
+        "type": "string"
+      },
+      "requirement": {
+        "anyOf": [
+          {
+            "additionalProperties": {},
+            "properties": {
+              "details": {
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "propertyNames": {
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "type": {
+                "description": "Requirement type (e.g. purchase_add_on).",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "What is needed to resolve the error, when applicable."
+      }
+    },
+    "required": [
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / results / items / properties / downloadUrl / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / results / items / properties / downloadUrl / type
```
Added value: +[
+  "string",
+  "null"
+]
```
removedOutput schema / properties / results / items / properties / downloadUrlExpiresAt / anyOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / results / items / properties / downloadUrlExpiresAt / type
```
Added value: +[
+  "number",
+  "null"
+]
```
removedOutput schema / properties / results / items / properties / file / properties / description / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / results / items / properties / file / properties / description / type
```
Added value: +[
+  "string",
+  "null"
+]
```

changedOutput schema / properties / results / items / properties / file / properties / downloadSource / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "description": "A file rendition source (thumbnail, preview, download, …).",
-    "properties": {
-      "expiresAt": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Unix expiry for url."
-      },
-      "fileBytes": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Rendition size in bytes."
-      },
-      "height": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Rendition height in pixels."
-      },
-      "status": {
-        "description": "Rendition status.",
-        "enum": [
-          "pending",
-          "ready",
-          "failed",
-          "skipped"
-        ],
-        "type": "string"
-      },
-      "url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Signed URL when status is ready."
-      },
-      "width": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Rendition width in pixels."
-      }
-    },
-    "required": [
-      "status"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "description": "A file rendition source (thumbnail, preview, download, …).",
+    "properties": {
+      "expiresAt": {
+        "description": "Unix expiry for url.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "fileBytes": {
+        "description": "Rendition size in bytes.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "height": {
+        "description": "Rendition height in pixels.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "status": {
+        "description": "Rendition status.",
+        "enum": [
+          "pending",
+          "ready",
+          "failed",
+          "skipped"
+        ],
+        "type": "string"
+      },
+      "url": {
+        "description": "Signed URL when status is ready.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "width": {
+        "description": "Rendition width in pixels.",
+        "type": [
+          "number",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "status"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / results / items / properties / file / properties / downloadUrl / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / results / items / properties / file / properties / downloadUrl / type
```
Added value: +[
+  "string",
+  "null"
+]
```
removedOutput schema / properties / results / items / properties / file / properties / downloadUrlExpiresAt / anyOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / results / items / properties / file / properties / downloadUrlExpiresAt / type
```
Added value: +[
+  "number",
+  "null"
+]
```
removedOutput schema / properties / results / items / properties / file / properties / durationSeconds / anyOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / results / items / properties / file / properties / durationSeconds / type
```
Added value: +[
+  "number",
+  "null"
+]
```

changedOutput schema / properties / results / items / properties / file / properties / hlsSource / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "description": "A file rendition source (thumbnail, preview, download, …).",
-    "properties": {
-      "expiresAt": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Unix expiry for url."
-      },
-      "fileBytes": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Rendition size in bytes."
-      },
-      "height": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Rendition height in pixels."
-      },
-      "status": {
-        "description": "Rendition status.",
-        "enum": [
-          "pending",
-          "ready",
-          "failed",
-          "skipped"
-        ],
-        "type": "string"
-      },
-      "url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Signed URL when status is ready."
-      },
-      "width": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Rendition width in pixels."
-      }
-    },
-    "required": [
-      "status"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "description": "A file rendition source (thumbnail, preview, download, …).",
+    "properties": {
+      "expiresAt": {
+        "description": "Unix expiry for url.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "fileBytes": {
+        "description": "Rendition size in bytes.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "height": {
+        "description": "Rendition height in pixels.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "status": {
+        "description": "Rendition status.",
+        "enum": [
+          "pending",
+          "ready",
+          "failed",
+          "skipped"
+        ],
+        "type": "string"
+      },
+      "url": {
+        "description": "Signed URL when status is ready.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "width": {
+        "description": "Rendition width in pixels.",
+        "type": [
+          "number",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "status"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / results / items / properties / file / properties / previewSource / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "description": "A file rendition source (thumbnail, preview, download, …).",
-    "properties": {
-      "expiresAt": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Unix expiry for url."
-      },
-      "fileBytes": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Rendition size in bytes."
-      },
-      "height": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Rendition height in pixels."
-      },
-      "status": {
-        "description": "Rendition status.",
-        "enum": [
-          "pending",
-          "ready",
-          "failed",
-          "skipped"
-        ],
-        "type": "string"
-      },
-      "url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Signed URL when status is ready."
-      },
-      "width": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Rendition width in pixels."
-      }
-    },
-    "required": [
-      "status"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "description": "A file rendition source (thumbnail, preview, download, …).",
+    "properties": {
+      "expiresAt": {
+        "description": "Unix expiry for url.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "fileBytes": {
+        "description": "Rendition size in bytes.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "height": {
+        "description": "Rendition height in pixels.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "status": {
+        "description": "Rendition status.",
+        "enum": [
+          "pending",
+          "ready",
+          "failed",
+          "skipped"
+        ],
+        "type": "string"
+      },
+      "url": {
+        "description": "Signed URL when status is ready.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "width": {
+        "description": "Rendition width in pixels.",
+        "type": [
+          "number",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "status"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / results / items / properties / file / properties / publicHlsUrl / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / results / items / properties / file / properties / publicHlsUrl / type
```
Added value: +[
+  "string",
+  "null"
+]
```
removedOutput schema / properties / results / items / properties / file / properties / publicPlaybackId / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / results / items / properties / file / properties / publicPlaybackId / type
```
Added value: +[
+  "string",
+  "null"
+]
```

changedOutput schema / properties / results / items / properties / file / properties / thumbnailSource / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "description": "A file rendition source (thumbnail, preview, download, …).",
-    "properties": {
-      "expiresAt": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Unix expiry for url."
-      },
-      "fileBytes": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Rendition size in bytes."
-      },
-      "height": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Rendition height in pixels."
-      },
-      "status": {
-        "description": "Rendition status.",
-        "enum": [
-          "pending",
-          "ready",
-          "failed",
-          "skipped"
-        ],
-        "type": "string"
-      },
-      "url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Signed URL when status is ready."
-      },
-      "width": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Rendition width in pixels."
-      }
-    },
-    "required": [
-      "status"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "description": "A file rendition source (thumbnail, preview, download, …).",
+    "properties": {
+      "expiresAt": {
+        "description": "Unix expiry for url.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "fileBytes": {
+        "description": "Rendition size in bytes.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "height": {
+        "description": "Rendition height in pixels.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "status": {
+        "description": "Rendition status.",
+        "enum": [
+          "pending",
+          "ready",
+          "failed",
+          "skipped"
+        ],
+        "type": "string"
+      },
+      "url": {
+        "description": "Signed URL when status is ready.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "width": {
+        "description": "Rendition width in pixels.",
+        "type": [
+          "number",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "status"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / results / items / properties / file / properties / thumbnailUrl / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / results / items / properties / file / properties / thumbnailUrl / type
```
Added value: +[
+  "string",
+  "null"
+]
```
removedOutput schema / properties / results / items / properties / file / properties / thumbnailUrlExpiresAt / anyOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / results / items / properties / file / properties / thumbnailUrlExpiresAt / type
```
Added value: +[
+  "number",
+  "null"
+]
```
removedOutput schema / properties / results / items / properties / file / properties / transcriptText / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / results / items / properties / file / properties / transcriptText / type
```
Added value: +[
+  "string",
+  "null"
+]
```
removedOutput schema / properties / results / items / properties / file / properties / type / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / results / items / properties / file / properties / type / type
```
Added value: +[
+  "string",
+  "null"
+]
```
removedOutput schema / properties / results / items / properties / thumbnailUrl / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / results / items / properties / thumbnailUrl / type
```
Added value: +[
+  "string",
+  "null"
+]
```
removedOutput schema / properties / results / items / properties / thumbnailUrlExpiresAt / anyOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / results / items / properties / thumbnailUrlExpiresAt / type
```
Added value: +[
+  "number",
+  "null"
+]
```

Changed1 schema field changedOct 16, 2026

changedInput schema / properties / videoFileId / description

Previous value: -"Source video file id."New value: +"Video to transform. Use fileId from upload_file, list_files, or a succeeded video-generation result."

First observedOct 9, 2026

TDQS

A4/5.0

Behavior4/5

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

Annotations already declare readOnlyHint=false and destructiveHint=false, so the safety bar is partly covered; the description usefully reinforces this by stating the source file is unchanged and that a new copy is produced. It also discloses the asynchronous nature via toolExecutionId and the polling path through get_tool_execution, which annotations do not convey. It does not mention that non-idempotent repeated calls create multiple copies, nor cost or processing time.

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?

Three short sentences, front-loaded with the core action, then the return/handoff contract, then the non-destructive guarantee. Every sentence carries distinct information with no redundancy.

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?

With annotations covering the safety profile and an output schema handling return values, the description is nearly complete: it covers the action, the async handoff, and the source-file guarantee. Minor gaps remain around idempotency implications, expected processing time, and any constraints on the input video.

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

Parameters3/5

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

Schema coverage is 100% and the single videoFileId parameter is fully documented in the schema, including where to obtain it (upload_file, list_files, or a succeeded generation result). The description adds no parameter-level meaning beyond that, so the baseline 3 applies.

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 gives a specific verb and resource — 'Create a higher-resolution copy of an existing video' — which is unambiguous and clearly distinct from siblings like upscale_image, video_to_video, or remove_video_background. An agent can select this tool without opening the schema.

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

Usage Guidelines3/5

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

It implicitly guides the async workflow by naming toolExecutionId and pointing to get_tool_execution for status and output, which is useful. However, it never states when to choose this over adjacent tools such as video_to_video or upscale_image, and gives no prerequisites (e.g., resolution limits or supported formats), leaving selection guidance to inference.

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

All VideoGen tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.