Skip to main content
Glama

PMFlow MCP (Lite)

License: MIT Python: 3.10+ MCP Standard: Compatible

Autonomous Product Management Workflow, PRD Engine & BDD Story Validator for AI Agents

PMFlow MCP gives AI agents (Claude Desktop, Cursor, Devin, Roo-Code) the capabilities of a Senior Technical Product Manager. It generates structured Product Requirement Documents (PRDs), decomposes epics into testable User Stories, validates Given/When/Then acceptance criteria for testability, and exports markdown backlogs.


πŸš€ Features (Lite Edition)

  • Automated PRD Generator (generate_prd): Creates complete PRD specifications with MoSCoW prioritization, functional requirements, technical constraints, risks, and measurable KPIs.

  • Atomic Story Decomposer (decompose_stories): Formats requirements into standard agile format: "As a [persona], I want [goal], so that [benefit]" with estimated story points.

  • BDD/Gherkin Syntax Validator (validate_acceptance_criteria): Enforces Given/When/Then syntax, flags ambiguous terms (e.g., "fast", "intuitive", "easy") that cause agent drift, and calculates a 0-100 testability score.

  • Markdown Specification Exporter (export_markdown_specs): Generates clean, commit-ready documentation for repositories.


Related MCP server: Agile Planner MCP Server

πŸ“¦ Installation & Setup

git clone https://github.com/johannschiffer/pmflow-mcp.git
cd pmflow-mcp
pip install -e .

Configuration with Claude Desktop / Cursor

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "pmflow": {
      "command": "python3",
      "args": ["-m", "pmflow.server"]
    }
  }
}

⚑ Quick CLI Usage

# Generate a PRD in Markdown
pmflow prd \
  --title "Payment Gateway Integration" \
  --problem "Customers cannot check out with Apple Pay" \
  --audience "Mobile checkout shoppers" \
  --features "Stripe SDK setup" "Apple Pay button" "Webhook listener" \
  --markdown

# Validate BDD Acceptance Criteria
pmflow validate --criteria \
  "Given user is on checkout page" \
  "When user taps Apple Pay button" \
  "Then payment sheet opens within 300ms"

πŸ’Ό Upgrade to PMFlow Pro

Need enterprise capabilities for multi-agent swarms? Check out PMFlow Pro:

  • User Story Dependency DAG Engine: Cycle detection via Kahn's algorithm and critical path calculation in SQLite WAL.

  • Sprint Velocity & Capacity Forecaster: Monte Carlo simulation of agent capacity and bottleneck alerts.

  • Issue Tracker Exporter: Automatic sync with Jira, Linear, and GitHub Issues.

  • Docker Compose: Production containerization ready for agent clusters.

Available at Gumroad.


πŸ“„ License

MIT Β© Johann Schiffer

Available Tools

4 tools
decompose_storiesC

Decomposes a requirement into an atomic User Story with BDD Given/When/Then acceptance criteria.

Inputs: goal (required), title (required), benefit (required), persona (required), +4 more.

export_markdown_specsC

Exports structured PRD and story backlog into standardized Markdown documentation.

Inputs: prd, stories.

generate_prdC

Generates a structured, production-ready PRD with requirements, tech stack, constraints, and success metrics.

Inputs: title (required), key_features (required), target_audience (required), problem_statement (required), +2 more.

validate_acceptance_criteriaB

Validates acceptance criteria syntax (Given/When/Then) and flags non-testable or ambiguous language.

Inputs: criteria (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool targets a distinct artifact and action in the pipeline: PRD generation, story decomposition, criteria validation, and markdown export. There is no meaningful overlap, so an agent can select the right tool unambiguously.

    Naming Consistency5/5

    All four tools follow a consistent snake_case verb_noun pattern (generate_prd, decompose_stories, validate_acceptance_criteria, export_markdown_specs). The convention is uniform and predictable.

    Tool Count4/5

    Four tools map cleanly onto the generate-decompose-validate-export pipeline, which is well-scoped rather than bloated. It is slightly thin, but each tool clearly earns its place.

    Completeness3/5

    The core generation pipeline is covered, but there are no read/update/delete operations, so an agent cannot retrieve, revise, or list existing PRDs and stories. This is a notable gap for a document-authoring workflow.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Implements GitHub's Spec-Driven Development methodology, transforming natural language requirements into executable specifications, technical plans, and ordered task lists with contract-based validation and progress tracking.
      26 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Automatically generates structured agile backlogs including epics, features, and user stories from natural language descriptions within AI-powered IDEs. It streamlines project management by creating AI-optimized markdown files and directory structures to guide step-by-step implementation.
      18 npm
      3
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to research, plan, generate requirements and user stories, create starter projects, analyze codebases, curate context, manage tasks, and execute multi-step development workflows.
      69 npm
      MIT