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 delegateagents(array): Array of subagent configurationsrole(string): Agent role (e.g., "backend_developer", "frontend_developer")instructions(string): Specific instructions for the agentrecipe(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 reciperole(string): Agent roleinstructions(string): Detailed instructionsextensions(array, optional): Goose extensions to enableparameters(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 logicfrontend_developer- UI/UX implementation, client-side codedatabase_engineer- Schema design, query optimizationdevops_engineer- Deployment, CI/CD, infrastructureqa_engineer- Testing, quality assurancesecurity_auditor- Security review, vulnerability assessmentcode_reviewer- Code quality, best practicesdocumentation_writer- Technical documentation, API docsproject_architect- System design, architecture planning
Environment Variables
ALPHA_FEATURES=true- Required for Goose subagentsGOOSE_RECIPE_PATH- Path to custom recipe directory
Troubleshooting
- Subagents not working: Ensure
ALPHA_FEATURES=trueis set - Goose not found: Verify Goose CLI is installed and in PATH
- Recipe not found: Check
GOOSE_RECIPE_PATHor place recipes in working directory
License
MIT