get_job_status

Poll a long-running MCP job by id. Returns the current status plus result or error once the worker finishes.

Purpose

Poll a long-running MCP job by id. Returns the current status plus result or error once the worker finishes. Tokens are restricted to jobs the authenticated user kicked off — foreign jobs return RESOURCE_NOT_FOUND to prevent existence leaks.

Status values: queued → running → completed | failed.

Required ability

mcp:full

Input schema

{
  "type": "object",
  "required": ["job_id"],
  "properties": {
    "job_id": {
      "type": "string",
      "description": "UUID of the async job to poll."
    }
  }
}

Output shape

{
  "data": {
    "job_id": "mjb_01HX...",
    "tool_name": "bulk_generate_access_codes",
    "status": "completed",
    "result": { "count": 50, "batch_unique_key": "..." },
    "error": null,
    "started_at": "2026-05-18T10:05:00Z",
    "completed_at": "2026-05-18T10:05:04Z"
  }
}

Example prompts

"Check the status of job mjb_01HX...."

"Is my access-code batch done yet?"

Failure modes

RESOURCE_NOT_FOUND — unknown job_id, or the job was kicked off by a different user.
AUTHENTICATION_REQUIRED — no authenticated user on the request.
TOKEN_MISSING_ABILITY — token lacks mcp:full.