delegate
Offload large, mechanical, or exploratory coding work to a sandboxed sub-agent that reads the repository and returns a written report, saving your context.
Instructions
Run a bounded sub-agent on the user's NVIDIA NIM account and return its written report.
Reach for this to keep large, mechanical, or exploratory work out of your own context: tracing how a feature flows across many files, auditing a directory for a pattern, summarising an unfamiliar module or dependency, drafting a migration plan, reviewing a diff. The sub-agent reads the repository itself and spends NIM tokens doing it; you only receive the finished report.
task must stand on its own. The sub-agent cannot see this conversation, your open
files, the user's last message, or anything you have already worked out - it starts cold
at the repo root. Spell out what to look at, what to produce, and what "done" means.
Good: "Find every call site of load_config under submcp/ and list each as path:line
with one line on how the result is used; answer as a markdown list."
Bad: "look into that config thing we discussed".
Parameters: task - self-contained instructions, including the output format you want back. profile - "general" (default), "researcher", "coder", or "reviewer". Researcher for read-and-explain sweeps, coder for focused edits, reviewer for critique. files - paths to hand over up front so the sub-agent doesn't waste steps hunting. write - allow file edits. Off by default, and ignored entirely unless the server was started with SUBMCP_ALLOW_WRITE=1. Leave it off for investigation. model - override the NIM model for this run (default stepfun-ai/step-3.7-flash). max_steps - tool-call budget for this run (default 12).
Returns a markdown report: the sub-agent's findings, plus the model used, how many steps
it took, which tools it called, and any files it changed. The sub-agent is sandboxed to
the server's root directory, is read-only unless write=True, cannot run shell commands
unless the operator enabled SUBMCP_ALLOW_SHELL, and refuses to read secrets (.env,
private keys, credentials files).
For several independent subtasks, call delegate_parallel once instead of calling this
tool repeatedly - it runs them concurrently over one connection.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task | Yes | ||
| files | No | ||
| model | No | ||
| write | No | ||
| profile | No | general | |
| max_steps | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |