Skip to main content
Glama

Get Video Job

get_job
Read-onlyIdempotent

Get the status of a video background removal job started with remove_video_background (or by remove_background given an animated GIF). Polling is free. When status is completed the job carries result_url, a direct download link valid for 24 hours.

Input Schema

NameRequiredDescriptionDefault
job_idYesJob id returned by remove_video_background (starts with job_)

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A4.4/5.0
Behavior4/5

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

Annotations already cover the safety profile (readOnly, idempotent, non-destructive), so the description's added value is what it says beyond them: polling carries no cost, the job surfaces result_url on completion, and that download link expires in 24 hours. The expiry window is a genuinely useful operational constraint an agent would otherwise miss; only the set of possible status values is left undisclosed.

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 tight sentences with no filler. Purpose, provenance, cost, and the completion/expiry behavior are all front-loaded in the order an agent needs them.

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 no output schema, the description correctly carries the return-value burden, naming the result_url field and its 24-hour validity. The one gap is the enumeration of non-completed statuses, which matters for an agent writing a polling loop, but everything needed to call the tool correctly is present.

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?

Schema coverage is 100% and the schema already documents the job_id format ('starts with job_'), so the baseline is 3. The description adds provenance the schema lacks — which tools generate this id — which helps an agent confirm it is passing the right identifier.

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?

States a specific verb and resource ('Get the status of a video background removal job') and explicitly ties it to the originating tools, remove_video_background and remove_background. This clearly separates it from the sibling get_account and from the two removal tools that create the job.

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?

Explains the polling use case, that polling is free (a cost signal that encourages repeated calls), and what to wait for ('When status is completed'). It names the tools that produce the job_id, but does not state an explicit stop condition or what to do on failure, so it falls just short of the full when/when-not/alternatives bar.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources