mcp-server-subagent

Subagent MCP Server

mcp-server-subagent lets planning agents delegate work to executor agents through the Amazon Q and Claude CLIs. It supports asynchronous runs, progress checks, log retrieval, and questions exchanged between parent agents and sub-agents.

Server facts

mcp-server-subagent

Project

Author
dvcrn
License
AGPL-3.0 license

Tech

Runtime / language
node
Transports
stdio
Remote available
No
Authentication
Not specified

Activity

GitHub stars
15
Last commit
Data as of

Tags

  • mcp server
  • sub agent
  • task delegation

Overview

Delegating execution to Amazon Q or Claude is the central workflow in mcp-server-subagent. A planning agent submits task input through run_subagent_q or run_subagent_claude, which starts an asynchronous sub-task and returns a run identifier. That identifier connects later progress checks through check_subagent_status with output retrieval through get_subagent_logs. Sub-agents use update_subagent_status to record their execution state and optionally attach a result summary. The project also provides streaming output for monitoring work as it runs, with stored records covering output, prompts, and run metadata.

Parent involvement can continue after delegation rather than ending at task submission. When an executor needs clarification, ask_parent creates a question associated with its run. The parent answers that specific message through reply_subagent, while check_message_status lets the executor retrieve the response and acknowledges it when available. This supports workflows where a planner assigns work but still supplies guidance during execution. The implementation runs on Node, communicates over stdio, and documents extending its sub-agent configuration to add other executors.

mcp-server-subagent setup notes

  • mcp-server-subagent records stdio only; confirm a network transport upstream before planning remote access.

Related MCP servers