monte_carlo_schedule
Run Monte Carlo simulation on task duration estimates to forecast schedule risk, returning P10–P95 completion estimates and deadline probability.
Instructions
Run Monte Carlo simulation for probabilistic schedule risk analysis.
Samples task durations from triangular distributions and returns P10/P50/P80/P95 completion estimates with identified risk events. Use seed for reproducible results. Supply target_hours (working hours; durations are 8-hour days) to get criticalPathProbability = P(total <= target_hours); without it that field is null.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"tasks": "<tasks>"
},
"name": "monte_carlo_schedule"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | Optional seed for reproducible results. | |
| tasks | Yes | Task list with PERT-style three-point estimates and dependency edges. | |
| project | No | Optional project/repo identifier this estimate belongs to, for cross-project analytics. | |
| task_type | No | Optional task type for feedback matching. Enables per-task-type accuracy tracking. | |
| iterations | No | Number of Monte Carlo simulation iterations (1–100,000). Higher = more stable percentiles. | |
| session_id | No | Optional session identifier (minted by a calling agent/hook) used to deduplicate repeated estimate calls for the same task within a session. | |
| task_label | No | Optional free-text label identifying the task this estimate is for (e.g. an issue key or short title). Surfaced on get_pending_estimates output for triage. | |
| distribution | No | When true, also return the simulated distribution (20 bin edges and counts in days, plus the P50/P90 bins) so a client can draw the chart. | |
| target_hours | No | Optional deadline in working hours (task durations are in 8-hour days). When supplied, criticalPathProbability reports P(total <= target_hours); when omitted it is null instead of a fabricated value. |