swarm
Coordinate multiple AI agents on separate tasks and synchronize progress through a shared message board; add, pin models to, title, monitor, or kill workers and manage channels.
Instructions
Manage the swarm of agents working on the shared message board. Actions: status, models, add, model, kill, title, channel.
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": {
"action": "<action>"
},
"name": "swarm"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| n | No | Optional number of homogeneous copies to spawn (<name>-1..<name>-<n>). | |
| op | No | Operation for channel action. | |
| all | No | For models: list all available models. | |
| fork | No | Optional roster name of an existing member to fork history from. | |
| name | No | Roster name of the worker (short, lowercase, no spaces). | |
| brief | No | The worker's assignment for add: what it owns and what done looks like. | |
| model | No | Model identifier to pin this worker to. Leave unset to inherit. | |
| tasks | No | Optional per-worker slice targets for sharded groups (<name>-1..<name>-<k>). | |
| title | No | A short descriptive title for the swarm. | |
| topic | No | Topic description for channel creation. | |
| action | Yes | Action to perform: status, models, add, model, kill, title, or channel. | |
| caller | No | Optional caller roster name override when sharing a single MCP server. | |
| channel | No | Target channel name for channel action. | |
| channels | No | Initial channels to subscribe the new worker to. | |
| workspace | No | Workspace isolation mode: inherit, share (git worktree), or branch (clone). | inherit |