MCP Goose Subagents Server

An MCP (Model Context Protocol) server that enables AI clients to delegate tasks to autonomous developer teams using Goose CLI subagents.

Features

Delegate to Subagents: Create specialized AI agents for different development roles
Parallel & Sequential Execution: Run agents simultaneously or in sequence
Recipe System: Create reusable agent configurations
Session Management: Track and retrieve results from active subagent sessions
Pure Goose CLI Integration: Uses only Goose CLI for subagent delegation

Prerequisites

Goose CLI installed and configured
Node.js (v18 or higher)
Alpha features enabled for Goose subagents

Installation

npm install

Usage

1. Add to MCP Configuration

Add this server to your MCP client configuration (e.g., mcp_config.json):

{
  "mcpServers": {
    "goose-subagents": {
      "command": "node",
      "args": ["path/to/mcp-goose-subagents/src/index.js"],
      "env": {
        "ALPHA_FEATURES": "true"
      }
    }
  }
}

2. Enable Goose Alpha Features

export ALPHA_FEATURES=true

Available Tools

`delegate_to_subagents`

Delegate development tasks to specialized Goose subagents.

Parameters:

task (string): The development task to delegate
agents (array): Array of subagent configurations
- role (string): Agent role (e.g., "backend_developer", "frontend_developer")
- instructions (string): Specific instructions for the agent
- recipe (string, optional): Recipe name to use
execution_mode (string): "parallel" or "sequential"
working_directory (string, optional): Working directory for agents

Example:

{
  "task": "Build a REST API with authentication",
  "agents": [
    {
      "role": "backend_developer",
      "instructions": "Create Express.js API with JWT authentication"
    },
    {
      "role": "database_engineer", 
      "instructions": "Design and implement user database schema"
    },
    {
      "role": "security_auditor",
      "instructions": "Review authentication implementation for security issues"
    }
  ],
  "execution_mode": "parallel"
}

`create_goose_recipe`

Create reusable Goose recipes for specialized subagents.

Parameters:

recipe_name (string): Name of the recipe
role (string): Agent role
instructions (string): Detailed instructions
extensions (array, optional): Goose extensions to enable
parameters (object, optional): Recipe parameters

`list_active_subagents`

List currently active subagent sessions and their status.

`get_subagent_results`

Retrieve results from completed subagent sessions.

Parameters:

session_id (string): Session ID to get results for

Example Workflows

Autonomous Full-Stack Development

// Delegate a complete web app development task
{
  "task": "Create a todo app with React frontend and Node.js backend",
  "agents": [
    {
      "role": "project_architect",
      "instructions": "Design overall architecture and create project structure"
    },
    {
      "role": "backend_developer", 
      "instructions": "Build REST API with CRUD operations for todos"
    },
    {
      "role": "frontend_developer",
      "instructions": "Create React components and integrate with API"
    },
    {
      "role": "qa_engineer",
      "instructions": "Write tests and ensure quality standards"
    }
  ],
  "execution_mode": "sequential"
}

Parallel Code Review

{
  "task": "Review authentication module for security and performance",
  "agents": [
    {
      "role": "security_auditor",
      "instructions": "Analyze for security vulnerabilities and best practices"
    },
    {
      "role": "performance_reviewer",
      "instructions": "Identify performance bottlenecks and optimization opportunities"  
    },
    {
      "role": "code_quality_reviewer",
      "instructions": "Check code style, maintainability, and documentation"
    }
  ],
  "execution_mode": "parallel"
}

Agent Roles Examples

backend_developer - API development, server-side logic
frontend_developer - UI/UX implementation, client-side code
database_engineer - Schema design, query optimization
devops_engineer - Deployment, CI/CD, infrastructure
qa_engineer - Testing, quality assurance
security_auditor - Security review, vulnerability assessment
code_reviewer - Code quality, best practices
documentation_writer - Technical documentation, API docs
project_architect - System design, architecture planning

Environment Variables

ALPHA_FEATURES=true - Required for Goose subagents
GOOSE_RECIPE_PATH - Path to custom recipe directory

Troubleshooting

Subagents not working: Ensure ALPHA_FEATURES=true is set
Goose not found: Verify Goose CLI is installed and in PATH
Recipe not found: Check GOOSE_RECIPE_PATH or place recipes in working directory

License

MIT

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

An MCP server that enables AI clients to delegate tasks to autonomous developer teams using Goose CLI subagents, supporting parallel and sequential execution across specialized roles like backend developers, frontend developers, and security auditors.

Related MCP Servers

kube-mcp
lochgeo
-
security
A
license
-
quality
An MCP server that enables interaction with Kubernetes/Minikube clusters through natural language, allowing AI agents like Codename Goose to manage Kubernetes resources via the Model Context Protocol.
Last updated -
2
Python
MIT License
Vibe Coder MCP
freshtechbro
A
security
F
license
A
quality
An MCP server that supercharges AI assistants with powerful tools for software development, enabling research, planning, code generation, and project scaffolding through natural language interaction.
Last updated -
11
64
62
TypeScript
Goose App Maker MCP
michaelneale
A
security
F
license
A
quality
This MCP server allows users to create, manage, and serve web applications through Goose, storing apps in configurable directories and providing web app serving capabilities.
Last updated -
9
2
JavaScript
Kubernetes MCP
yurinnick
-
security
A
license
-
quality
An MCP server that enables interaction with Kubernetes resources through natural language interfaces like Goose CLI, allowing users to get, read, and patch Kubernetes resources.
Last updated -
Python
Apache 2.0

View all related MCP servers

MCP Goose Subagents Server