subagent_spawn
Start a subagent run to perform file operations and execute commands within a specified directory, supporting read-only exploration or writable work.
Instructions
Start an Open Subagent MCP run.
agent_type must be "explorer" for read-only exploration or "worker" for writable work. By default, Open Subagent MCP may only access files under cwd. Repository-external paths must be declared in allowed_external_roots and still pass realpath, symlink, and sensitive path checks.
Keep timeout_seconds <= 120 for normal tasks. For larger tasks, increase max_steps first and narrow the search scope. If timeout_seconds > 120 is required, pass explicit_authorizations=["long_running_commands"].
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": {
"agent_type": "<agent_type>",
"message": "<message>",
"cwd": "<cwd>"
},
"name": "subagent_spawn"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent_type | Yes | ||
| message | Yes | ||
| cwd | Yes | ||
| items | No | ||
| fork_context | No | ||
| model | No | ||
| dry_run | No | ||
| max_steps | No | ||
| timeout_seconds | No | ||
| allowed_external_roots | No | ||
| explicit_authorizations | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||