Skip to main content
Glama

Get Job

lab_get_job
Read-only

Get the status of a background job by job_id (status is queued|processing|done|failed). Poll this after starting a long-running generate/export. Returns the job record; its payload and result are objects (for a clip chain: result.zusammenfassung, result.ketten, result.clips). For an Umzug import (lab_umzug): result.bildzeilen (image_id, datei), result.gesperrt (datei, grund), result.ungeprueft. Pass wait_s (up to 80) to wait inside the call until the job is done or failed instead of polling in quick succession.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
job_idYesThe job id returned by a generate/export tool
wait_sNoWait up to this many seconds (max 80) for done/failed; the answer says gewartet_s

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / additionalProperties
      Added value: +false
  2. Changed1 schema field changed
    • addedInput schema / properties / wait_s
      Added value: +{
      +  "description": "Wait up to this many seconds (max 80) for done/failed; the answer says gewartet_s",
      +  "maximum": 80,
      +  "minimum": 0,
      +  "type": "integer"
      +}
  3. First observed

TDQS

A3.9/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true, so the safety profile is covered. Beyond that the description adds real behavior: the four possible status values, the shape of result for a clip chain vs. an Umzug import, and the semantics of waiting inside the call (with gewartet_s reported). It omits what happens on an unknown/expired job_id, keeping it out of the top band.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the core purpose, then the status enum, then return shapes, then the wait hint. Dense and mostly waste-free, though the two long result-shape enumerations make it longer than a minimal status tool needs.

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 takes on the burden of explaining the return value for two concrete job types and the wait behavior. It is nearly complete; only failure/unknown-job handling and the sibling overlap remain unaddressed.

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 description coverage is 100%, and both parameters (job_id and wait_s, with its 0-80 bound) are already fully documented in the schema. The description largely restates this ('wait_s (up to 80)'), adding only the rationale for using it over rapid polling, which is the expected baseline-plus behavior.

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

Purpose4/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 background job by job_id') with the domain of statuses enumerated. It does not, however, distinguish itself from the very similar siblings lab_job_status or lab_batch_status, so an agent must guess which of the three to call.

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?

Explicitly says to poll this 'after starting a long-running generate/export' and to prefer wait_s 'instead of polling in quick succession', which is actionable context. It stops short of naming the sibling alternatives (lab_job_status, lab_jobs_inflight) that would resolve the overlap.

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