Skip to main content
Glama

Agile Team MCP Server

A team of Agent Personas wrapped in an MCP server that has the ability to leverage at scale massive compute by wrapping various LLM providers to perform activities as an Agile Team Persona.

Features

  • Model Wrapping: Send prompts to multiple LLM models with a unified interface

  • Provider/Model Correction: Automatically correct and validate provider and model names

  • File Support: Send prompts from files and save responses to files

  • Provider/Model Discovery: List available providers and models

  • Persona Tools: Specialized personas like Business Analyst, Product Manager, Spec Writer, and Team Decision Maker

Related MCP server: AI Cognitive Nexus

Setup

Installation

# Clone and install
git clone https://github.com/danielscholl/agile-team-mcp-server.git
cd agile-team-mcp-server
uv sync

# Install
uv pip install -e .

# Run tests to verify installation
uv run pytest

Environment Configuration

Create and edit your .env file with your API keys:

# Create environment file from template
cp .env.sample .env

Required API keys in your .env file:

# Required API keys
OPENAI_API_KEY=your_openai_api_key_here
ANTHROPIC_API_KEY=your_anthropic_api_key_here
GEMINI_API_KEY=your_gemini_api_key_here  # For Google Gemini models
GROQ_API_KEY=your_groq_api_key_here
DEEPSEEK_API_KEY=your_deepseek_api_key_here
OLLAMA_HOST=http://localhost:11434

# Optional model configuration
DEFAULT_MODEL=openai:gpt-4o-mini
DEFAULT_TEAM_MODELS=["openai:gpt-4.1","anthropic:claude-3-7-sonnet","gemini:gemini-2.5-pro"]
DEFAULT_DECISION_MAKER_MODEL=openai:gpt-4o-mini

MCP Server Configuration

To utilize this MCP server directly in other projects either use the buttons to install in VSCode, edit the .mcp.json file directory.

Clients tend to have slighty different configurations

Install with UV in VS Code Install with Docker in VS Code

Configure for Claude.app

{
  "mcpServers": {
    "agile-team": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/danielscholl/agile-team-mcp-server@main",
        "agile-team"
      ],
      "env": {
        "OPENAI_API_KEY": "<YOUR_OPENAI_KEY>",
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_KEY>",
        "GEMINI_API_KEY": "<YOUR_GEMINI_KEY>",
        "GROQ_API_KEY": "<YOUR_GROQ_KEY>",
        "DEEPSEEK_API_KEY": "<YOUR_DEEPSEEK_KEY>",
        "OLLAMA_HOST": "http://localhost:11434",
        "DEFAULT_MODEL": "openai:gpt-4o-mini",
        "DEFAULT_TEAM_MODELS": "[\"openai:gpt-4.1\",\"anthropic:claude-3-7-sonnet\",\"gemini:gemini-2.5-pro\"]",
        "DEFAULT_DECISION_MAKER_MODEL": "openai:gpt-4o-mini"
      }
    }
  }
}

Configure for Claude.code

Setting up Agile Team with Claude Code easily by importing it.

claude mcp add-from-claude-desktop

Note: "--directory" would be the path to the source code if not in the same directory.

# Copy this JSON configuration
{
    "command": "uvx",
    "args": ["--from", "git+https://github.com/danielscholl/agile-team-mcp-server@main", "agile-team"],
    "env": {
        "DEFAULT_MODEL": "openai:gpt-4o-mini",
        "DEFAULT_TEAM_MODELS": "[\"openai:gpt-4.1\",\"anthropic:claude-3-7-sonnet\",\"gemini:gemini-2.5-pro\"]",
        "DEFAULT_DECISION_MAKER_MODEL": "openai:gpt-4o-mini"
    }
}

# Then run this command in Claude Code
claude mcp add agile-team "$(pbpaste)"

To remove the configuration later:

claude mcp remove agile-team

Available LLM Providers

Provider

Short Prefix

Full Prefix

Example Usage

OpenAI

o

openai

o:gpt-4o-mini

Anthropic

a

anthropic

a:claude-3-5-haiku

Google Gemini

g

gemini

g:gemini-2.5-pro-exp-03-25

Groq

q

groq

q:llama-3.1-70b-versatile

DeepSeek

d

deepseek

d:deepseek-coder

Ollama

l

ollama

l:llama3.1

Usage

Command Line

Run the server directly:

uv run agile-team

With MCP Client

With a compatible MCP client, you can connect to the server:

mcp use agile-team

Available Prompts

Interactive conversation starters and guided workflows to help you discover and use server capabilities.

List MCP Assets

Get a comprehensive overview of all server capabilities including tools, personas, providers, and workflows.

Parameters: None required

Usage:

# Get complete server capability overview
list_mcp_assets

Returns: Comprehensive markdown documentation including:

  • All available tools with parameters and examples

  • Supported LLM providers with shortcuts and usage examples

  • Agent personas (Business Analyst, Product Manager, Spec Writer, Decision Maker)

  • Quick start workflows for agile team processes

  • Advanced usage patterns and best practices

  • Pro tips for model selection and workflow optimization

This prompt provides a self-documenting overview of the entire agile-team MCP server, making it easy to discover capabilities and get started with productive workflows.

Available Tools

List Available Options

Tools to discover available LLM providers and their supported models.

List Providers Tool

Lists all supported LLM providers and their shortcut prefixes.

Parameters: None required

Examples:

# Simple example
list_providers_tool

List Models Tool

Lists all available models for a specific provider.

Parameters:

Parameter

Description

Default Value

provider

The provider to list models for (e.g., "openai", "anthropic")

required

Examples:

# Simple example with full provider name
list_models_tool: "openai"

# Using provider shortcode
list_models_tool: "a"  # Lists Anthropic models

Send Prompts to Models

Send text prompts directly to LLM models and get their responses.

Parameters:

Parameter

Description

Default Value

text

The prompt text to send to the models

required

models_prefixed_by_provider

List of models in format "provider:model"

openai:gpt-4o-mini

Features:

  • Send prompts to one or multiple models simultaneously

  • Use model suffixes for special behaviors:

    • :4k or other numbers for thinking token budgets

    • :high for increased reasoning effort (OpenAI only)

Examples:

# Simple example
prompt_tool: "Create a plan for implementing user authentication"

# Complex example with multiple models and options
prompt_tool: "Analyze the trade-offs between microservices and monoliths" ["openai:gpt-4.1:high", "anthropic:claude-3-7-sonnet:4k"]

Work with Files

Process prompts from files and save responses to files for batch processing.

From File Tool

Parameters:

Parameter

Description

Default Value

file_path

Path to the file containing the prompt

required

models_prefixed_by_provider

List of models in format "provider:model"

openai:gpt-4o-mini

Examples:

# Simple example
prompt_from_file_tool: "prompts/function.md"

# Complex example with specific model
prompt_from_file_tool: "prompts/function.md" ["anthropic:claude-3-7-sonnet-20250219"]

From File to File Tool

Parameters:

Parameter

Description

Default Value

file_path

Path to the file containing the prompt

required

models_prefixed_by_provider

List of models in format "provider:model"

openai:gpt-4o-mini

output_path

Full path for the output file

Generated based on input

output_dir

Directory for response files

input file's directory/responses

output_extension

File extension for output files

md

Examples:

# Simple example
prompt_from_file2file_tool: "prompts/uv_script.md"

# Complex example with specific model, output path and custom extension
prompt_from_file2file_tool: "prompts/diagram.md" ["anthropic:claude-3-7-sonnet"] "prompts/responses/architecture_diagram.md"

Team Decision Making

Use multiple models as team members to generate different solutions, then have a decision maker model evaluate and choose the best approach.

Parameters:

Parameter

Description

Default Value

from_file

Path to the file containing the prompt

required

models_prefixed_by_provider

List of team member models

["openai:gpt-4.1", "anthropic:claude-3-7-sonnet", "gemini:gemini-2.5-pro"]

persona_dm_model

Model for making the decision

openai:gpt-4o-mini

output_path

Full path for the output document

Generated based on input

output_dir

Directory for response files

input file's directory/responses

output_extension

File extension for output files

md

persona_prompt

Custom decision maker prompt

Default template

Examples:

# Simple example
persona_dm_tool: "prompts/decision.md"

# Complex example with custom team and decision maker model
persona_dm_tool: "prompts/decision.md" ["o:gpt-4.1", "a:claude-3-7-sonnet", "g:gemini-2.5-pro-preview-03-25"] persona_dm_model="o:o3" "prompts/responses/final_decision.md"

Business Analyst Persona

Generate detailed business analysis using a specialized Business Analyst persona, with optional team-based decision making.

Capabilities:

  • Creating detailed project briefs and requirement documents

  • Analyzing business needs and market opportunities

  • Defining MVP scope and feature prioritization

  • Identifying target audiences and user personas

Parameters:

Parameter

Description

Default Value

from_file

Path to the file containing business requirements

required

models_prefixed_by_provider

Models to use in format "provider:model"

openai:gpt-4o-mini

output_path

Full path for the output document

Generated based on input

output_dir

Directory for response files

input file's directory/responses

output_extension

File extension for output files

md

use_decision_maker

Whether to use team decision making

false

decision_maker_models

Models for team members if using decision maker

["openai:gpt-4.1", "anthropic:claude-3-7-sonnet", "gemini:gemini-2.5-pro"]

decision_maker_model

Model for final decision making

openai:gpt-4o-mini

Examples:

# Simple example
persona_ba_tool: "prompts/concept.md" "prompts/responses/project-brief.md"

# Complex example with team-based decision making
persona_ba_tool: "prompts/concept.md" use_decision_maker=true decision_maker_model="o:04-mini" "prompts/responses/project-brief.md"

Product Manager Persona

Generate comprehensive product management plans using a specialized Product Manager persona, with optional team-based decision making.

Capabilities:

  • Creating detailed product plans with prioritized features and clear timelines

  • Developing product vision and strategy

  • Performing market and competitive analysis

  • Defining user stories and requirements

  • Managing cross-functional team collaboration

  • Implementing data-driven decision making

Parameters:

Parameter

Description

Default Value

from_file

Path to the file containing the product requirements

required

models_prefixed_by_provider

Models to use in format "provider:model"

openai:gpt-4o-mini

output_path

Full path for the output document

Generated based on input

output_dir

Directory for response files

input file's directory/responses

output_extension

File extension for output files

md

use_decision_maker

Whether to use team decision making

false

decision_maker_models

Models for team members if using decision maker

["openai:gpt-4.1", "anthropic:claude-3-7-sonnet", "gemini:gemini-2.5-pro"]

decision_maker_model

Model for final decision making

openai:gpt-4o-mini

pm_prompt

Custom Product Manager prompt template

Default template

decision_maker_prompt

Custom decision maker prompt template

Default template

Examples:

# Simple example
persona_pm_tool: "prompts/responses/project-brief.md" "prompts/responses/project-prd.md"

# Complex example with team-based decision making
persona_pm_tool: "prompts/responses/project-brief.md" use_decision_maker=true decision_maker_model="o:gpt-4o-mini" "prompts/responses/project-prd.md"

Spec Writer Persona

Generate clear, developer-ready specification documents from PRDs, project briefs, or user requests using a specialized Spec Writer persona.

Capabilities:

  • Producing technical specifications from PRDs or project briefs

  • Defining step-by-step implementation instructions for developers and AI agents

  • Creating comprehensive specifications with architectural patterns and validation criteria

  • Defining tool behavior, CLI structure, directory layout, and testing plans

  • Using focused, reproducible examples to communicate architectural patterns

  • Ensuring each spec includes validation steps to verify implementation

Parameters:

Parameter

Description

Default Value

from_file

Path to the file containing requirements or PRD

required

models_prefixed_by_provider

Models to use in format "provider:model"

openai:gpt-4o-mini

output_path

Full path for the output document

Generated based on input

output_dir

Directory for response files

input file's directory/responses

output_extension

File extension for output files

md

use_decision_maker

Whether to use team decision making

false

decision_maker_models

Models for team members if using decision maker

["openai:gpt-4.1", "anthropic:claude-3-7-sonnet", "gemini:gemini-2.5-pro"]

decision_maker_model

Model for final decision making

openai:gpt-4o-mini

sw_prompt

Custom Spec Writer prompt template

Default template

decision_maker_prompt

Custom decision maker prompt template

Default template

Examples:

# Simple example - generate a specification from a PRD
persona_sw_tool: "prompts/responses/project-prd.md" "prompts/responses/project-spec.md"

# Complex example with team-based decision making
persona_sw_tool: "prompts/responses/project-prd.md" use_decision_maker=true decision_maker_model=["o:gpt-4o-mini"] "prompts/responses/project-spec.md"

Available Tools

9 tools
list_models_toolB
List all available models for a specific provider.

Args:
    provider: The provider to list models for (e.g., "openai", "anthropic")

Returns:
    List of model names available for the specified provider

Inputs: provider (required).

list_providers_toolB
List all supported LLM providers.

Returns:
    Dictionary with main providers and their shortcuts clearly formatted

Inputs: no named parameters.

persona_ba_toolB
Generate business analysis using a specialized Business Analyst persona, with optional decision making.

This tool uses a specialized Business Analyst prompt to analyze business requirements
from a file. It can either use a single model or leverage the team decision-making
functionality to get multiple perspectives and consolidate them.

Args:
    from_file: Path to the file containing the business requirements
    models_prefixed_by_provider: List of models in format "provider:model"
                                (if None, defaults to DEFAULT_MODEL)
    output_dir: Directory where response files should be saved (defaults to input file's directory/responses)
    output_extension: File extension for output files (e.g., 'py', 'txt', 'md')
    output_path: Optional full output path with filename for the output document
    use_decision_maker: Whether to use the decision maker functionality
    decision_maker_models: Models to use if use_decision_maker is True
                         (if None, defaults to DEFAULT_TEAM_MODELS)
    ba_prompt: Custom business analyst prompt template
    decision_maker_model: Model to use for decision making (defaults to DEFAULT_DECISION_MAKER_MODEL)
    decision_maker_prompt: Custom persona prompt template for decision making

Returns:
    Path to the business analysis output file

Inputs: from_file (required), models_prefixed_by_provider, output_dir, output_extension, +6 more.

persona_dm_toolB
Generate responses from multiple LLM models and use a decision maker model to choose the best direction.

This tool first sends a prompt from a file to multiple models, then uses a designated
decision maker model to evaluate all responses and provide a final decision.

Args:
    from_file: Path to the file containing the prompt text
    models_prefixed_by_provider: List of team member models in format "provider:model" 
                                (if None, defaults to ["openai:gpt-4.1", "anthropic:claude-3-7-sonnet", "gemini:gemini-2.5-pro"])
    output_dir: Directory where response files should be saved (defaults to input file's directory/responses)
    output_extension: File extension for output files (e.g., 'py', 'txt', 'md')
    output_path: Optional full output path with filename for the persona document
    persona_dm_model: Model to use for making the decision (defaults to DEFAULT_DECISION_MAKER_MODEL)
    persona_prompt: Custom persona prompt template (if None, uses the default)

Returns:
    Path to the persona output file

Inputs: from_file (required), models_prefixed_by_provider, output_dir, output_extension, +3 more.

persona_pm_toolC
Generate product management plans using a specialized Product Manager persona, with optional decision making.

This tool uses a specialized Product Manager prompt to create comprehensive product plans
from a file. It can either use a single model or leverage the team decision-making
functionality to get multiple perspectives and consolidate them.

Args:
    from_file: Path to the file containing the product requirements
    models_prefixed_by_provider: List of models in format "provider:model"
                                (if None, defaults to DEFAULT_MODEL)
    output_dir: Directory where response files should be saved (defaults to input file's directory/responses)
    output_extension: File extension for output files (e.g., 'py', 'txt', 'md')
    output_path: Optional full output path with filename for the output document
    use_decision_maker: Whether to use the decision maker functionality
    decision_maker_models: Models to use if use_decision_maker is True
                         (if None, defaults to DEFAULT_TEAM_MODELS)
    pm_prompt: Custom product manager prompt template
    decision_maker_model: Model to use for decision making (defaults to DEFAULT_DECISION_MAKER_MODEL)
    decision_maker_prompt: Custom persona prompt template for decision making

Returns:
    Path to the product plan output file

Inputs: from_file (required), models_prefixed_by_provider, output_dir, output_extension, +6 more.

persona_sw_toolB
Generate specification documents using a specialized Spec Writer persona, with optional decision making.

This tool uses a specialized Spec Writer prompt to create comprehensive specification documents
from a file. It can either use a single model or leverage the team decision-making
functionality to get multiple perspectives and consolidate them.

Args:
    from_file: Path to the file containing the requirements or PRD
    models_prefixed_by_provider: List of models in format "provider:model"
                                (if None, defaults to DEFAULT_MODEL)
    output_dir: Directory where response files should be saved (defaults to input file's directory/responses)
    output_extension: File extension for output files (e.g., 'py', 'txt', 'md')
    output_path: Optional full output path with filename for the output document
    use_decision_maker: Whether to use the decision maker functionality
    decision_maker_models: Models to use if use_decision_maker is True
                         (if None, defaults to DEFAULT_TEAM_MODELS)
    sw_prompt: Custom spec writer prompt template
    decision_maker_model: Model to use for decision making (defaults to DEFAULT_DECISION_MAKER_MODEL)
    decision_maker_prompt: Custom persona prompt template for decision making

Returns:
    Path to the specification output file

Inputs: from_file (required), models_prefixed_by_provider, output_dir, output_extension, +6 more.

prompt_from_file2file_toolA
Read a prompt from a file, send it to multiple LLM models, and write responses to files.

Args:
    file_path: Path to the file containing the prompt text
    models_prefixed_by_provider: List of models in format "provider:model" (e.g., "openai:gpt-4").
                                 If None, defaults to ["openai:gpt-4o-mini"]
    output_dir: Directory where response files should be saved (defaults to input file's directory/responses)
    output_extension: File extension for output files (e.g., 'py', 'txt', 'md')
                      If None, defaults to 'md' (default: None)
    output_path: Optional full output path with filename. If provided, the extension
                 from this path will be used (overrides output_extension).

Returns:
    List of file paths where responses were written

Inputs: file_path (required), models_prefixed_by_provider, output_dir, output_extension, +1 more.

prompt_from_file_toolB
Read a prompt from a file and send it to multiple LLM models.

Args:
    file_path: Path to the file containing the prompt text
    models_prefixed_by_provider: List of models in format "provider:model" (e.g., "openai:gpt-4").
                                 If None, defaults to ["openai:gpt-4o-mini"]

Returns:
    List of responses, one from each specified model

Inputs: file_path (required), models_prefixed_by_provider.

prompt_toolA
Send a text prompt to multiple LLM models and return their responses.

Args:
    text: The prompt text to send to the models
    models_prefixed_by_provider: List of models in format "provider:model" (e.g., "openai:gpt-4").
                                 If None, defaults to ["openai:gpt-4o-mini"]

Returns:
    List of responses, one from each specified model

Inputs: text (required), models_prefixed_by_provider.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 9 tools

    Disambiguation3/5

    There is significant functional overlap between tools, particularly among the persona tools (ba, dm, pm, sw) which share similar decision-making functionality and parameters, and between prompt_from_file_tool and prompt_tool which differ only in input source. However, the descriptions help clarify distinctions, such as persona specializations and file vs. text input.

    Naming Consistency3/5

    The naming follows a mixed convention: most tools use snake_case with descriptive names (e.g., list_models_tool, persona_ba_tool), but there are inconsistencies like 'prompt_from_file2file_tool' which uses '2' instead of 'to', and 'prompt_tool' is overly generic compared to others. The pattern is readable but not fully uniform.

    Tool Count4/5

    With 9 tools, the count is reasonable for an LLM orchestration and persona-based server. It covers provider/model listing, persona generation, and prompt handling, though some tools feel redundant (e.g., multiple persona tools with similar structures). The scope is well-defined but could be streamlined.

    Completeness4/5

    The server provides good coverage for LLM model management and persona-based generation, with tools for listing providers/models, sending prompts, and specialized personas. Minor gaps include lack of update/delete operations for models or personas, and no tool for managing provider configurations, but core workflows are supported.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables dynamic creation and orchestration of hierarchical AI agent teams with role-based personas and domain knowledge injection. Supports multi-agent collaboration, session management, and complex task execution through structured team workflows.
      15
      -
    • A
      license
      B
      quality
      D
      maintenance
      Orchestrates complete agile development workflows from product requirements to QA testing through role-based stages (PO → Architect → SM → Dev → Review → QA). Manages workflow state, generates role-specific prompts, and saves artifacts while integrating with multiple AI engines for comprehensive project delivery.
      1
      11 npm
      19
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A multi-agent collaboration platform that provides access to over 1,500 models from 68 providers via the Model Context Protocol. It enables users to assemble and coordinate specialized AI teams using advanced orchestration modes like swarm, debate, and hierarchical workflows.
      4
      AGPL 3.0