Skip to main content

GetMcpJob

Returns the status of an asynchronous MCP job. Used for any operation that returns a job_id instead of an immediate result.

PropertyValue
Required scopemcp:read
RiskNone. Read-only.
Side effectsNone.

When an agent should use it​

  • After any tool that returned a job_id (RunStrategyBacktest, CompileNinjaScript, parameter sweeps, large reads).
  • To poll progress and final state.

Parameters​

{ "job_id": "b-9001" }

Response shape​

{
  "job_id": "b-9001",
  "type": "backtest",
  "status": "running",
  "progress": 0.42,
  "started_at": "2026-05-15T14:00:00Z",
  "result": null
}

Status transitions: queued → running → completed | failed | cancelled. On completed the result field is populated.

Example user prompt​

After RunStrategyBacktest, poll GetMcpJob every few seconds until status is
completed or failed. When done, summarize the metrics block.