mcp-delegate
Summary: This server lets you delegate tasks to other models (local Ollama or remote OpenRouter/OpenAI-compatible endpoints) via subagent-style calls, and inspect what past delegations did.
delegate_task— Run a single-shot chat completion on a configured backend and get the model's text response back verbatim; supportssystem_prompt, per-callmodeloverride, a namedbackendfrommodels.json, and optional transcript capture.delegate_agentic_task— Hand a multi-step task to a model with its own tool-use loop (read_file,write_file,run_bash) scoped to a caller-specifiedworking_dir, bounded bymax_iterations(default 20) andtimeout_seconds(default 600); returns only the final answer.list_recent_delegations— Inspect recent calls (backend, model, task, duration, iterations, success, token usage, USD cost where the provider reports it, truncated result) newest first, so you can see what happened without re-running anything.get_delegation_transcript— Fetch the full message/tool-call transcript for one delegation that was run withcapture_transcript=True(useful for model bake-offs/comparison), returning an error string if none was captured.Multi-backend fan-out — Each call can target a different backend/model in the same turn (e.g.
ollama-localfor one call,openrouter-freefor another), with in-process concurrency capped byDELEGATE_MAX_CONCURRENCY.Error handling — Failures (bad config, unreachable endpoint, timeout, iteration cap) come back as
"Error: ..."strings rather than raised exceptions, so a calling agent can see what went wrong.
(Note: the list_recent_delegations description still references a pricing.json entry for cost, but the README says that was replaced by provider-reported cost; the schema also doesn't reflect the README's statement that delegate_agentic_task's vision/image handling was removed.)
Allows delegating a task to a model served by Ollama and returning the generated text response as the result.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-delegateDelegate the task of writing a project proposal to a separate agent."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
delegate
Delegates a task to a separate, full agentic loop running on a different model (local via Ollama, or remote via OpenRouter), with its own tool access (files, bash), returning only a final result — functionally equivalent to a native subagent, but model-agnostic. Driven from the command line by a person or a script.
See mcp-subagent-delegation-plan.md for the full build plan, phased as separate commits/checkpoints.
Status
Phase 1, 2, 3, and 4 complete.
delegate task— single-shot chat completion against a configured OpenAI-compatible endpoint (Ollama, LM Studio, vLLM, OpenRouter, ...).delegate agentic— gives the delegated model its own tool-use loop (read_file,write_file,run_bash) scoped to a caller-specified working directory, running until it stops calling tools, hitsmax_iterations, or exceedstimeout_seconds.delegate batch— a JSONL of jobs run concurrently in one process, under one semaphore.delegate list— inspect what past delegations actually did, without digging through logs or re-running anything.delegate transcript— full message/tool-call transcript for one delegation, when it was run with--capture-transcript(e.g. for model comparison/eval runs).
Deviation from the original plan: Phase 2 called for wrapping agent-loop as a subprocess. agent-loop only supports Linux/macOS/WSL, and this needs to run natively on Windows, so we built the in-process loop described as Phase 5's alternative instead — same tool interface, no subprocess/ANSI-stripping complexity, and it sidesteps agent-loop's AGPL/no-commercial license entirely. See delegate/agentic.py.
Safety note: working_dir is caller-specified, not a fixed sandbox — the delegated model
gets unattended file/bash access to whatever directory it's pointed at. File tools
(read_file/write_file) are scoped to stay within working_dir; run_bash runs with that
directory as cwd but shell commands are not fully sandboxed and could escape it (e.g. cd ..).
Point this at a directory you're comfortable an unattended model can read, write, and execute
commands in.
Guardrail note: the original plan's Phase 4 asked to confirm agent-loop's own guardrails
(iteration cap, repetition detection) were active. Since we're not using agent-loop, that
doesn't apply directly — our loop has its own max_iterations and timeout_seconds caps
(verified in testing), but no repetition detection. A model that gets stuck alternating between
two tool calls will run until it hits max_iterations rather than being caught early. Worth
adding if that turns out to happen in practice.
Binary files
read_file refuses binary files (tools.BINARY_EXTENSIONS — PDF, ZIP, .db, Office
formats, images — plus a null-byte sniff on the first 1 KB for anything not on that list)
instead of silently decoding them as garbled text. Before this guard existed, a delegated model
called read_file directly on three PDFs instead of extracting their text with
pypdf/pdfplumber first; .read_text(errors="replace") turned each one into a wall of �
characters — often more characters than the source file's own byte size, since many raw bytes
decode to multi-byte replacement characters — and the resulting ~1.9M-character blob blew
straight through the model's context window on the very next turn, before any real work
happened. Now that raises a clear ToolError naming the file type and pointing at the right
extraction library instead.
Images are on that list like anything else, so the error names the format ("PNG image") rather than falling through to the sniff's generic "binary data".
Tool results are capped
run_bash and read_file both return at most 10,000 characters (tools.MAX_OUTPUT_CHARS): the first 5,000, a
note saying how many were dropped and what to do instead, then the last 5,000. Head and tail,
because the tail is where a traceback and its failing line are, and a head-only cut throws away
the half worth reading. The [exit code: N] line is appended after truncation, never before, so
it cannot be the thing that gets cut.
This is the same failure the binary guard above exists for, arriving by a different door — a
cat of a room file, a chatty pip install, a wide find. The guard can refuse a file that is
the wrong kind; it can't refuse one that is merely large, and run_bash can't refuse anything
— so both truncate.
The advice in the notice differs by tool, because what the model can do about it differs.
Command output is gone once cut, so run_bash says to re-run something narrower. A file is
still sitting on disk unchanged, so read_file says to go back for the part it wants with
grep, sed -n 'START,ENDp', or head/tail. read_file matters more than it looks: workers
are told to extract a PDF's text to a file and read that back, and extracted text is exactly
what gets large.
Every command also runs with PAGER=cat, MANPAGER=cat, LESS=-R, PIP_PROGRESS_BAR=off and
TQDM_DISABLE=1. The two Python ones do the real work, since delegated workers are told to do
file operations in Python; the pager settings bind when a Unix tool gets invoked, which happens
because Git for Windows puts less/man on PATH. There is no stdin in a delegated run, so a
pager doesn't produce noise — it hangs until the timeout kills it.
Vision was removed
read_file used to detect images by extension and show them to the model as real multimodal
content, with downscaling and context pruning to keep an image-heavy run affordable. Visual
judgment on plans and RCPs moved to the take-off tool, so none of that is reachable any more and
it was deleted rather than left to rot.
It worked, and three things it had to get right are worth knowing before anyone adds vision back — all recoverable in full from the commit that removed this section:
A
tool-role message cannot carry animage_urlblock on any OpenAI-compatible provider, so the image has to go in a syntheticusermessage after every tool result for that turn.Pruning an old image means replacing the whole content block, not overwriting
image_url.urlwith placeholder text — OpenRouter validates that field as a URL and 400s.Without pruning, a real 3-room extraction task reached ~194K prompt tokens by iteration 20 and still didn't finish, almost entirely from re-sending every image it had ever viewed.
Related MCP server: deepseek-subagent-mcp
Setup
uv sync
cp .env.example .env # fill in DELEGATE_BASE_URL / DELEGATE_API_KEY / DELEGATE_MODEL
cp models.json.example models.json # optional: named backends, see belowMultiple backends
Both tools take an optional backend param that looks up base_url/model/api_key from
models.json instead of the default DELEGATE_* env vars — e.g. backend="ollama-local" for
one call and backend="openrouter-free" for another in the same turn, each running
concurrently. model, if also given, overrides just the model string within that backend.
Reference an env var for a key instead of writing it into models.json directly:
{
"openrouter-free": {
"base_url": "https://openrouter.ai/api/v1",
"model": "nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free",
"api_key_env": "OPENROUTER_API_KEY"
}
}models.json is gitignored, same as .env.
Concurrency
DELEGATE_MAX_CONCURRENCY (default 4, see .env.example) caps how many delegations — any
command, any backend — run at once, to avoid a large fan-out overwhelming a local model server
or a paid API's rate limits. It is an in-process semaphore, so use delegate batch to fan out
rather than launching N copies of the CLI from a shell loop; see the CLI section below.
Logging
Every task/agentic call — success or failure — is logged to a local
SQLite file, delegations.db (gitignored, created on first use): tool, backend, model, task
text, start/end time, iteration count, success/failure, a truncated result/error preview, and
token usage if the backend returned it. Query it with delegate list, or
directly with sqlite3 delegations.db "select * from delegations order by id desc limit 20".
Logging is best-effort — a logging failure won't take down an otherwise-successful delegation.
Both also append a trailing [tokens: N prompt / N completion / N total ($cost)] line to their
own output when the backend reports usage, so you see it immediately without a separate
delegate list call.
Cost tracking
The provider prices the call and tells us; nothing is looked up. OpenRouter returns a cost
field on every response's usage object — no request flag needed — and that number is summed
across a delegation's iterations, logged to delegations.db (cost_usd), and shown in the
[tokens: ...] suffix.
The distinction that matters: a missing cost is unknown, not free. Ollama and other local
endpoints have no such field, so those rows log cost_usd = NULL and print no dollar figure.
A model that genuinely costs nothing — OpenRouter's :free variants — reports cost: 0, which
is a fact and gets printed as $0.000000. Summing an absent field into 0.0 would render a
paid run as free, which is the one error this must never make.
This replaced a hand-maintained pricing.json. That file mapped model → per-million rates and
had to be re-fetched whenever a price moved or a model was added, and it could only ever cover
models someone had remembered to enter. Provider-reported cost is ground truth, covers every
model automatically, and cannot go stale. The two agreed where they overlapped: delegation 56
logged $0.01137843 from the table, which is exactly 353,970 prompt tokens at $0.03/M plus 5,841
completion tokens at $0.13/M.
Transcript capture (model comparison / eval runs)
Both take --capture-transcript (off by default). When set, the full message exchange —
every model message, tool call, and tool result, not just the final answer — is logged, and
the output gets a [delegation_id: N] suffix. Fetch it with
delegate transcript <delegation_id>.
This exists for running the same task through several different models/backends and comparing not just the final answer but how each one got there (tool selection, malformed tool calls, retries) — e.g. a bake-off across candidate models before picking one for production use. Off by default since it's extra logging overhead you don't want for routine delegation.
CLI
delegate/__main__.py is the only front door. An MCP server used to sit beside it, exposing
four of these commands as model-callable tools, but it was enabled in no project, never grew
batch, and made every change a question of whether both surfaces had been updated. Delegation
here is driven by a person or a script — which is what a bake-off or a batch run actually is.
py -m delegate task "summarise this" --backend openrouter --model qwen/qwen3.7-flash
py -m delegate agentic --dir ./sandbox --task-file step-600.md --backend openrouter
py -m delegate batch jobs.jsonl --out-dir results/
py -m delegate list --limit 10
py -m delegate transcript 42uv run delegate ... works too, via the [project.scripts] entry point.
--task-file is the point. A real task is paragraphs — a step file, a spec extract — and
shell-quoting that is how a task arrives mangled. Every command taking a prompt also accepts -
or a pipe, to read stdin.
batch, and why it exists
concurrency.limit_concurrency is an in-process semaphore. It caps parallel delegations inside
one invocation and cannot see any other, so launching N copies of this CLI from a shell loop gives
each its own cap and effectively removes it — a real way to trip a provider's rate limit or swamp a
local Ollama. batch runs every job in one process, under one semaphore.
Jobs are JSONL, one per line; # comments and blank lines are skipped. A job with a dir runs
agentic, one without runs single-shot; every other key matches the corresponding function argument.
{"name": "step-900", "task": "...", "dir": "./sandbox", "backend": "openrouter", "model": "qwen/qwen3.7-flash"}
{"name": "smoke", "task": "Reply with exactly: OK", "backend": "openrouter"}One job failing does not stop the rest. Each result lands in --out-dir/<name>.txt (or stdout),
failures included, and the exit status is non-zero if any job failed.
A retired model is an ordinary outcome, not a crash
Free-tier model ids get withdrawn without notice — nvidia/nemotron-nano-9b-v2:free began 404ing
three days after the bake-off measured it. The CLI prints that as one error line rather than a
traceback; pass --traceback when you want the stack because it really is a bug.
Tools
delegate_task(prompt, model=None, system_prompt=None, backend=None, capture_transcript=False) -> str— single-shot chat completion against the configured backend.delegate_agentic_task(task, working_dir, model=None, max_iterations=20, timeout_seconds=600, backend=None, capture_transcript=False) -> str— multi-step delegation withread_file/write_file/run_bashtools scoped toworking_dir. Returns only the final answer, not the full transcript, unlesscapture_transcript=True.read_fileon an image file shows it to a vision-capable model as an actual image — see "Vision" above.list_recent_delegations(limit=20) -> list[dict]— most recent logged delegations, newest first.get_delegation_transcript(delegation_id) -> list[dict]— full transcript for one delegation logged withcapture_transcript=True.
delegate_task/delegate_agentic_task return errors (bad config, unreachable endpoint,
timeout, iteration cap) as "Error: ..." strings rather than raising, so a calling agent can
see what went wrong.
Available Tools
4 toolsdelegate_agentic_taskA
Delegate a multi-step task to a model with its own tool-use loop (read_file, write_file, run_bash) scoped to working_dir. Runs until the model stops calling tools, hits max_iterations, or exceeds timeout_seconds. Returns only the final answer, not the full transcript.
The delegated model gets unattended file/bash access within working_dir for the duration of the call - point it at a directory you're comfortable it can read, write, and execute commands in.
Args:
task: The task instruction to give the delegated model.
working_dir: Directory the model's tools are scoped to.
model: Override just the model string for this call.
max_iterations: Stop after this many tool-call rounds.
timeout_seconds: Wall-clock budget for the whole task.
backend: Named backend from models.json (base_url/model/api_key) to
use instead of the default DELEGATE_* env vars. model, if also
given, overrides the model within that backend.
capture_transcript: Log every model message and tool call/result for
later retrieval via get_delegation_transcript, instead of just
the final answer. Off by default; useful when comparing models
(e.g. a bake-off) rather than for routine use.
| Name | Required | Description | Default |
|---|---|---|---|
| task | Yes | ||
| model | No | ||
| backend | No | ||
| working_dir | Yes | ||
| max_iterations | No | ||
| timeout_seconds | No | ||
| capture_transcript | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description fully carries the behavioral disclosure burden. It clearly states that the delegated model gets unattended read/write/execute access within working_dir, that only the final answer is returned, that there are termination conditions, and that transcript capture is opt-in. This is comprehensive and honest about side effects and limits.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Despite being long, the description is tightly structured: a core behavior paragraph, a safety warning, then a bulleted Args list. Every sentence earns its place, and the most important info (what it does, termination, permissions) is front-loaded. No fluff or redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a complex delegation tool with 7 parameters, no annotations, and a dangerous access profile, the description covers all critical aspects: scope, termination, access level, return value, optional transcript capture, and backend override. The existence of an output schema is acknowledged but not required to detailed since it says returns only the final answer. Nothing an agent needs to invoke it correctly is missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0%, so the description is the only source of parameter meaning. It explains every parameter in the Args block, including the nuanced interplay between model and backend (backend as a base_url/model/api_key bundle, and that `model` overrides within that backend). This fully compensates for the schema's lack of descriptions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description opens with a precise verb and resource: 'Delegate a multi-step task to a model with its own tool-use loop...'. It clearly states the operation's scope (working_dir) and distinguishes itself from tools like get_delegation_transcript by explaining that it returns only the final answer, not the full transcript. This is a specific, unambiguous definition that lets an agent know exactly what it does.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explains the conditions under which the delegated model stops (no more tool calls, max_iterations, timeout_seconds) and warns about unattended file/bash access. It also suggests capture_transcript for comparison scenarios, indirectly routing to get_delegation_transcript. However, it does not explicitly contrast with delegate_task or state when to choose this tool over that sibling, leaving some inference to the agent.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
delegate_taskA
Delegate a single-shot task to a configured OpenAI-compatible model (e.g. local Ollama or OpenRouter) and return its text response verbatim.
Args:
prompt: The task/question to send to the delegated model.
model: Override just the model string for this call.
system_prompt: Optional system prompt to steer the delegated model.
backend: Named backend from models.json (base_url/model/api_key) to
use instead of the default DELEGATE_* env vars. model, if also
given, overrides the model within that backend.
capture_transcript: Log the full message exchange for later retrieval
via get_delegation_transcript. Off by default; useful when
comparing models (e.g. a bake-off) rather than for routine use.
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | ||
| prompt | Yes | ||
| backend | No | ||
| system_prompt | No | ||
| capture_transcript | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, so the description carries the behavioral burden. It discloses the side-effect of transcript capture, the verbatim return behavior, and backend/model override semantics. It does not discuss latency, cost, or authentication, but those are not critical for selecting or invoking this tool correctly.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is organized with a front-loaded summary followed by a clear Args block. Every parameter is explained in one or two lines, and there is no redundant or filler content.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a single-shot delegation tool, the description covers purpose, parameter semantics, backend resolution, and the return behavior. With an output schema present and sibling context available, no critical invocation detail is missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema has 0% description coverage, but the description fully documents all five parameters, including the relationship between backend and model, overriding behavior, and the opt-in nature of capture_transcript. This completely compensates for the schema gap.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool 'Delegate a single-shot task to a configured OpenAI-compatible model' and 'return its text response verbatim.' The 'single-shot' qualifier distinguishes it from the sibling delegate_agentic_task, though it does not explicitly name that sibling.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It gives concrete guidance on when to use capture_transcript ('when comparing models, e.g. a bake-off') and when not ('rather than for routine use'), and explains backend selection versus DELEGATE_* env vars. It does not explicitly describe when to choose delegate_task over delegate_agentic_task, but context signals and the 'single-shot' phrasing provide reasonable guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_delegation_transcriptA
Full message transcript (every model message and tool call/result) for one delegation, if it was run with capture_transcript=True. Get the id from list_recent_delegations. Returns an error string if no transcript was captured for that id.
Args:
delegation_id: The id field from a list_recent_delegations row.
| Name | Required | Description | Default |
|---|---|---|---|
| delegation_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the burden. It discloses the error condition for missing transcripts, which is the key behavioral nuance. It does not explicitly state read-only semantics, but that is reasonably implied for a retrieval tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise, with two clear sentences and a brief args section. No redundant or filler content; it efficiently conveys all necessary information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given there is an output schema (as indicated in context), the description need not explain return formats. It covers the essential context: the source of the id, the capture condition, and error behavior. This makes it complete for a single-parameter retrieval tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The parameter delegation_id is explained beyond the schema: it is the id from a list_recent_delegations row. This provides actionable meaning on how to obtain the correct value, enhancing the bare integer type definition.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool returns the full transcript for a delegation, using a specific verb ('get') and resource ('transcript'). It is distinct from siblings (list_recent_delegations lists, delegate_task delegates), so no ambiguity.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly notes the precondition (capture_transcript=True), the error behavior when no transcript exists, and instructs to obtain the delegation_id from list_recent_delegations. This gives clear when-to-use guidance and differentiates it from alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
list_recent_delegationsA
List the most recent delegate_task / delegate_agentic_task calls (backend, model, task, duration, iterations, success, token usage, USD cost if the model has a pricing.json entry, truncated result), most recent first. Answers "what did the delegated model actually do" without re-running anything.
Args: limit: Max number of records to return (default 20).
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full behavioral disclosure burden. It discloses the read-only nature (without re-running), sorting (most recent first), truncation of results, and conditional cost reporting. It does not mention pagination or error behavior, but for a simple read-only listing tool these are minor omissions; the disclosed traits exceed typical descriptions.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is moderately concise, listing the returned fields in a parenthetical that is useful but slightly dense. The core purpose is stated upfront, and the parameter doc is separated. It could be tightened by moving the field list to a separate line, but it remains efficient and well-organized.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool has one optional parameter, no annotations, and an output schema (not provided). The description covers the return semantics (fields, ordering, truncation, cost condition) and the read-only intent. Given the simplicity, nothing essential for correct invocation is missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must compensate for the single parameter 'limit'. It does so explicitly: 'Max number of records to return (default 20).' This adds full semantic meaning beyond the bare schema field, making the tool usable without additional inference.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool lists recent delegate_task / delegate_agentic_task calls, enumerates the returned fields (backend, model, task, duration, iterations, success, token usage, USD cost, truncated result), and specifies ordering (most recent first). It also states the intended purpose—answering what a delegated model actually did—which distinguishes it from sibling tools that create delegations or fetch full transcripts.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies a clear use case for inspecting prior delegations without re-running them, but it does not explicitly contrast with siblings like get_delegation_transcript or delegate_task. It lacks explicit when-not-to-use guidance, though the mention of 'without re-running anything' strongly suggests a read-only inspection context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
4 tool updates
v0.1.0- First observed
delegate_agentic_task - First observed
delegate_task - First observed
get_delegation_transcript - First observed
list_recent_delegations
TDQS
Scored across 4 tools
Each tool has a distinct purpose: delegate_task for single-turn, delegate_agentic_task for multi-step with tool use, list_recent_delegations for querying history, and get_delegation_transcript for retrieving full logs. No overlap.
All tool names follow a consistent snake_case verb_noun pattern (delegate_task, delegate_agentic_task, list_recent_delegations, get_delegation_transcript), with clear action prefixes.
Four tools precisely cover the core delegation workflow: create a delegation (two variants), list delegations, and inspect a transcript. No unnecessary extras.
The tool set covers creating delegations, retrieving summaries, and fetching full transcripts. No update/delete is needed for delegation records, so the surface is complete for its purpose.
Maintenance
Related MCP Connectors
- AgentdaOAuthcom.myagentda
Agent-native task management: your AI agent is the interface. Delegate to anyone by email.
Task-first cross-agent collaboration for discussions, review, referrals, and reusable knowledge.
Durable agent-to-agent handoffs and shared scratchpad for multi-agent workflows.
MCP delegation fallback for AI agents to discover capabilities, knowledge, tools, and collaborators.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables Claude to delegate tasks to external coding agents (Codex or Antigravity) for independent reviews, separate quota usage, and async processing.6MIT
- AlicenseAqualityBmaintenanceEnables AI coding agents like Claude Code or Codex to delegate tasks to a DeepSeek Harness subagent with its own context window, providing tools for task delegation, result waiting, continuation, and supervision with sandboxed execution.6MIT
- AlicenseAqualityBmaintenanceLets MCP clients like Codex delegate independent sub-tasks to DeepSeek as a sub-agent via a single tool, with optional context, custom system prompts, and configurable model/temperature settings.19MIT
- AlicenseAqualityBmaintenanceEnables delegating coding tasks to a pi agent as a steerable background worker, allowing mid-run redirection, follow-ups, and keeping the delegate's context isolated from your main conversation.121216MIT