execute_swarm
Start a swarm run by providing a natural-language task; returns a run contract with wave summary and cost estimate or a budget preview. Supports multiple topologies like star or hierarchical.
Instructions
Start a swarm run; returns an immediate run contract (swarm_id, wave summary, cost estimate) or a budget preview.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task | Yes | Natural-language task description (required). Use a plain quoted string — same shape as plan_task/decompose_task. | |
| topology | No | ||
| task_spec | No | Optional structured swarm payload (id, subtasks, complexity_score, …). When set, overrides task for planning/runtime handoff. | |
| task_text | No | Alias for task when callers use task_text instead of task. | |
| max_agents | No | ||
| budget_limit | No | ||
| urgency_hint | No | ||
| preview_token | No | ||
| workspace_root | No | Workspace where declared subtask outputs are materialized. Defaults to the active MCP workspace. | |
| unlimited_budget | No | Disable token budget circuit breaker and cost limit checks — swarm runs to completion regardless of token usage. |