assess_convergence

Judge whether a finished simulation converged by the user’s own standard.

Scope: jobs:read. Catalogue annotation: Read. Additional ownership and role checks may apply.

REST: POST /v1/jobs/{job_id}/convergence.

Arguments

Field

Type / accepted values

Required

Default

Constraints / meaning

window_fraction

number

No

0.2

maximum: 1; exclusiveMinimum: 0; Share of the iterations run, counted back from the last, that the test examines.

window_iterations

integer or null

No

null

minimum: 10; maximum: 100000000; Examine this many final iterations instead of window_fraction.

force_band_percent

number

No

1.0

maximum: 100; exclusiveMinimum: 0; Largest max-min spread of each force coefficient over the window, as a percentage of its mean.

force_band_floor

number

No

0.001

minimum: 0; maximum: 1; Spread always allowed, for coefficients near zero.

forces

array of string or null

No

null

minItems: 1; maxItems: 16; Force coefficients to judge, e.g. drag_coefficient; default every one reported.

residuals

array of string or null

No

null

minItems: 1; maxItems: 16; Residuals to judge, e.g. continuity; default every one reported.

residual_rise_orders

number

No

0.5

maximum: 10; exclusiveMinimum: 0; A residual is rising when the window’s later half is this many orders of magnitude above its earlier half.

min_residual_orders_dropped

number or null

No

null

minimum: 0; maximum: 20; Also require each residual to have fallen this many orders of magnitude from its peak.

max_final_residual

number or null

No

null

maximum: 1; exclusiveMinimum: 0; Also require each final residual to be at or below this value.

job_id

string (uuid)

Yes

Omitted

Calling the tool

Use tools/call with this tool’s exact name and an arguments object matching the fields above. Get the complete live schema before supplying advanced controls:

{
  "name": "get_tool_schema",
  "arguments": {
    "name": "assess_convergence",
    "include_definitions": false
  }
}

Result and continuation

Inspect isError and structuredContent. Keep returned job, operation and artifact IDs. A pending operation_id is followed with get_operation; a compute job is followed with get_job. A wait timeout does not cancel work. Follow returned polling intervals and retain the same idempotency key when reconciling the same submission.

See agent workflow, jobs and operations, uploads, results and error recovery for the applicable lifecycle. MCP annotations describe tool behaviour; they are not blanket permission to run paid work or change account state.