MCP Goose Subagents Server

You can delegate development tasks to specialized Goose subagents through an MCP server that uses Goose CLI for subagent delegation. This approach lets you run multiple agents in parallel or in sequence, reuse configurations with recipes, and track results from active sessions in a streamlined way.

How to use

Use this server with your MCP client to delegate tasks to Goose subagents. You can create specialized roles, run agents in parallel or in sequence, and manage sessions to retrieve results. Define reusable recipes for common workflows and enable alpha Goose features to access the full subagent capabilities.

How to install

Prerequisites must be in place before you run the server. Ensure Goose CLI is installed and configured, Node.js is available, and alpha features are enabled for Goose subagents.

Step by step, install dependencies and prepare the local MCP Goose Subagents server.

Additional content

Configuration and startup details are provided below. This server integrates with your MCP client configuration and runs as a local stdio process that Node.js executes.

Environment variables shown here are required to enable Goose alpha features and to locate any custom recipe paths you might use.

Troubleshooting tips help you diagnose common problems, such as missing Goose features, or misconfigured recipes.

Usage prerequisites and configuration highlights

Prerequisites you need to satisfy first: Goose CLI installed and configured, Node.js (version 18 or higher), and Alpha features enabled for Goose subagents.

Troubleshooting

If subagents stop working, verify that alpha features are enabled. If Goose is not found, confirm Goose CLI is installed and available in your PATH. If a recipe cannot be found, check the GOOSE_RECIPE_PATH or ensure the recipe exists in your working directory.

Available tools

delegate_to_subagents

Delegate development tasks to specialized Goose subagents with defined roles, instructions, and execution mode.

create_goose_recipe

Create reusable Goose recipes for configuring subagents with specific roles and instructions.

list_active_subagents

List currently active subagent sessions and their statuses.

get_subagent_results

Retrieve results from completed subagent sessions.