# Pm Skills Mcp

> MCP server exposing 40 PM skills + 11 workflows + 8 utility tools (59 tools) via Model Context Protocol. In maintenance mode (v2.9.x line, latest v2.9.3; catalog frozen at v2.9.2 build). For new users, the file-based install from product-on-purpose/pm-skills is recommended.

- **Type:** MCP server
- **Install:** `agentstack add mcp-product-on-purpose-pm-skills-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [product-on-purpose](https://agentstack.voostack.com/s/product-on-purpose)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [product-on-purpose](https://github.com/product-on-purpose)
- **Source:** https://github.com/product-on-purpose/pm-skills-mcp

## Install

```sh
agentstack add mcp-product-on-purpose-pm-skills-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

PM-Skills MCP
  

Open-source MCP server exposing 40 best-practice product management skills plus workflows and lifecycle tools, instantly accessible to any AI via Model Context Protocol.

  Report a Bug
  ·
  Request a Feature
  ·
  Ask a Question

  
  
    
  
  
    
  
  
    
  
  
    
  
  
    
  
  
    
  

> **Want to customize skills or use slash commands?** This server is powered by [pm-skills](https://github.com/product-on-purpose/pm-skills), the open-source skill library you can fork and modify. Browse the full catalog, interactive showcase, and setup guides at [product-on-purpose.github.io/pm-skills](https://product-on-purpose.github.io/pm-skills/).

> [!IMPORTANT]
> **Maintenance Mode (effective 2026-05-04)**
>
> Active development on `pm-skills-mcp` is paused pending demonstrated demand. The latest release is **v2.9.3** (security patch shipped 2026-05-05; embedded catalog frozen at the v2.9.2 build) which remains fully functional and exposes a catalog of 40 PM skills, 11 workflows, and 8 utility tools (59 tools total) via the Model Context Protocol. Security patches and critical bug fixes will continue to be addressed; new skill parity with the upstream [`pm-skills`](https://github.com/product-on-purpose/pm-skills) library is on hold, so the catalog will continue to drift from `pm-skills` as new skills are added there.
>
> **For new users:** the file-based install path documented in the [main `pm-skills` repository](https://github.com/product-on-purpose/pm-skills) is under active maintenance and is the recommended path going forward.
>
> **To register interest in resumed development:** [open a GitHub Discussion](https://github.com/product-on-purpose/pm-skills-mcp/discussions).

---

  About •
  Getting Started •
  Usage •
  Status •
  Contributing •
  Community

Table of Contents

- [The Big Idea](#the-big-idea)
  - [Why MCP?](#why-mcp)
  - [The Transformation](#the-transformation)
  - [Key Features](#key-features)
  - [Built with...](#built-with)
  - [Works for...](#works-for)
  - [Comparison: `pm-skills-mcp` (this repo) vs. `pm-skills`](#comparison-pm-skills-mcp-this-repo-vs-pm-skills)
- [Getting Started](#getting-started)
  - [NPM Global Install](#npm-global-install)
  - [From Source](#from-source)
  - [Quick Start by Platform](#quick-start-by-platform)
  - [Configuration](#configuration)
- [Usage](#usage)
  - [How It Works](#how-it-works)
  - [Tools](#tools)
  - [The Skills](#the-skills)
  - [🔗 Workflows - *Multi-skill workflows*](#-workflows---multi-skill-workflows)
  - [🛠️ Utility Tools](#️-utility-tools)
  - [MCP Resources](#mcp-resources)
  - [Prompts](#prompts)
- [Guides](#guides)
- [Project Status](#project-status)
  - [Releases](#releases)
  - [Project Structure](#project-structure)
  - [Changelog](#changelog)
  - [Roadmap](#roadmap)
- [Development](#development)
  - [Testing](#testing)
  - [Code Quality](#code-quality)
  - [CI/CD](#cicd)
- [Security](#security)
- [Contributing](#contributing)
  - [How to Contribute](#how-to-contribute)
  - [Reporting Bugs](#reporting-bugs)
- [About](#about)
  - [Author](#author)
  - [License](#license)
  - [Security](#security-1)
  - [Acknowledgments](#acknowledgments)
- [Community](#community)

---

**Quick Start** (NPM Global Install)

```bash
npm install -g pm-skills-mcp
```

---

## The Big Idea

**PM-Skills MCP** is an MCP server that transforms [PM-Skills](https://github.com/product-on-purpose/pm-skills), a collection of 40 best-practice product management skills, into programmatically accessible tools, resources, and prompts for any AI assistant that speaks the Model Context Protocol.

PM-Skills MCP is built on [pm-skills](https://github.com/product-on-purpose/pm-skills), an open-source collection of 40 PM skills organized by the Triple Diamond framework. While pm-skills offers file-based access with slash commands and AGENTS.md discovery, pm-skills-mcp wraps those same skills in an MCP server for programmatic access. The pm-skills library now includes **lifecycle tools** (Create, Validate, Iterate) and a [documentation site](https://product-on-purpose.github.io/pm-skills/) with an interactive showcase.

**Not sure which to use?** See the [Comparison](#comparison-pm-skills-mcp-this-repo-vs-pm-skills) section below, or the [MCP Setup Guide](https://product-on-purpose.github.io/pm-skills/guides/mcp-setup/) on the docs site.

**_One connection. 40 skills. Any MCP client._**

### Why MCP?

The [Model Context Protocol](https://modelcontextprotocol.io) is an open standard that lets AI assistants connect to external tools and data sources. Instead of manually copying skill files or uploading ZIP archives, PM-Skills MCP gives your AI **direct, programmatic access** to the entire PM skill library.

### The Transformation

| File-Based Approach                | MCP-Powered Approach              |
| ---------------------------------- | --------------------------------- |
| Clone repo, navigate to skills     | `npx pm-skills-mcp` - done        |
| Copy/paste skill content into chat | AI invokes tools directly         |
| Manual template injection          | Automatic template retrieval      |
| Platform-specific slash commands   | Universal across all MCP clients  |
| Static markdown files              | Dynamic, parameterized tools      |
| Works in one IDE/client            | Works everywhere MCP is supported |

### Key Features

- **59 MCP Tools** - 40 PM skills + 11 workflows + 8 utility tools
- **MCP Resources** - Skill instructions, templates, and examples via URI, with optional persona resources when enabled
- **3 MCP Prompts** - Guided conversation starters for common workflows
- **11 Workflows** - Pre-built multi-skill workflows for common scenarios
- **81 Automated Tests** - Comprehensive test coverage with Vitest
- **Zero Configuration** - Works out of the box with embedded skills
- **Universal Compatibility** - Claude Desktop, Cursor, Continue, and any MCP client
- **Customizable** - Override with your own skill modifications
- **Lightweight** - Minimal dependencies, fast startup
- **Security Scanning** - CodeQL analysis on every push

### Built with...

  
    
  
  
    
  
  
    
  

- **[Model Context Protocol](https://modelcontextprotocol.io)** - Open standard for AI tool connectivity
- **[PM-Skills](https://github.com/product-on-purpose/pm-skills)** - The 40 PM skills this server exposes ([docs site](https://product-on-purpose.github.io/pm-skills/))
- **[TypeScript](https://www.typescriptlang.org/)** - Type-safe implementation
- **[Vitest](https://vitest.dev/)** - Fast, modern testing framework

### Works for...

PM-Skills MCP works with any client that supports the Model Context Protocol. Here's a quick overview:

#### Platform Compatibility

| Platform            | Status       | Integration Type      | Notes                              |
| ------------------- | ------------ | --------------------- | ---------------------------------- |
| **Claude Code**     | ✅ Native    | MCP Server            | Full tool access via CLI           |
| **Claude Desktop**  | ✅ Native    | MCP Server            | Recommended for best experience    |
| **Claude.ai**       | ✅ Native    | MCP Server (Projects) | Via MCP integration in Projects    |
| **Cursor**          | ✅ Native    | MCP Server            | AI-powered IDE                     |
| **VS Code**         | ✅ Native    | Via Cline/Continue    | Multiple MCP-compatible extensions |
| **Continue**        | ✅ Native    | MCP Server            | Open-source coding assistant       |
| **Cline**           | ✅ Native    | MCP Server            | VS Code extension                  |
| **Windsurf**        | ✅ Native    | MCP Server            | AI-native IDE                      |
| **GitHub Copilot**  | 🔶 Indirect | Via MCP-enabled tools | Use with Copilot Chat + MCP        |
| **OpenCode**        | 🔶 Indirect | Via MCP-compatible config | Use standard stdio MCP server pattern |
| **ChatGPT / Codex** | 🔶 Manual   | Copy skill content    | No native MCP support              |
| **Any MCP Client**  | ✅ Universal | Protocol-level        | Full compatibility                 |

See the [Integration Guide](docs/integration-guide.md) for detailed setup instructions for each platform.

### Comparison: `pm-skills-mcp` (this repo) vs. `pm-skills`

`PM-Skills` is available in two complementary forms:

|  | pm-skills-mcp (this repo) | [pm-skills](https://github.com/product-on-purpose/pm-skills) |
|---|---|---|
| **What it is** | MCP server wrapping the skill library | Skill library as markdown files |
| **Access method** | `npx pm-skills-mcp` | Git clone, ZIP upload |
| **Setup time** | 30 seconds | 2-5 minutes |
| **Skill invocation** | MCP tool calls | Slash commands (Claude Code) |
| **Auto-discovery** | MCP protocol (Claude Desktop, Cursor) | AGENTS.md (Copilot, Cursor, Windsurf) |
| **Template access** | URI-based resources | Navigate file system |
| **Workflows** | Tool-based execution | Manual orchestration |
| **Customization** | Set `PM_SKILLS_PATH` to custom folder | Edit files directly |
| **Updates** | `npm update pm-skills-mcp` | `git pull` |

**Use `pm-skills-mcp` (this repo) when:**

- You want instant setup with `npx pm-skills-mcp`
- You're using Claude Desktop, Cursor, or any MCP client
- You want programmatic tool access without managing files
- You prefer consistent interfaces across different AI clients

**Use [pm-skills](https://github.com/product-on-purpose/pm-skills) (file-based) when:**

- You prefer slash commands in Claude Code (`/prd`, `/hypothesis`)
- You want to browse, read, and customize skill files directly
- You're using GitHub Copilot, OpenCode, or Windsurf without reliable MCP support
- You want to fork and heavily customize skills for your team

**Using Both Together:**
Fork [pm-skills](https://github.com/product-on-purpose/pm-skills) to customize skills, then point `pm-skills-mcp` to your fork:

```json
{
  "mcpServers": {
    "pm-skills": {
      "command": "npx",
      "args": ["pm-skills-mcp"],
      "env": {
        "PM_SKILLS_PATH": "/path/to/my/forked/pm-skills/skills"
      }
    }
  }
}
```

(back to top)

---

## Getting Started

This section covers quick installation. For a comprehensive walkthrough including core concepts, your first tool invocation, workflows, and troubleshooting, see the **[Getting Started Guide](docs/getting-started.md)**.

### NPM Global Install

```bash
npm install -g pm-skills-mcp
```

Run directly:

```bash
pm-skills-mcp
```

### From Source

```bash
git clone https://github.com/product-on-purpose/pm-skills-mcp.git
cd pm-skills-mcp
npm install
npm run build
npm start
```

### Quick Start by Platform

Claude Desktop

The recommended client for pm-skills-mcp. Add to your Claude Desktop configuration:

**Config file location:**
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
- Linux: `~/.config/Claude/claude_desktop_config.json`

**Configuration:**

```json
{
  "mcpServers": {
    "pm-skills": {
      "command": "npx",
      "args": ["pm-skills-mcp"]
    }
  }
}
```

Restart Claude Desktop. You now have access to all 40 PM skills as tools (catalog frozen at the v2.9.2 build; see Maintenance Mode notice above).

Claude Code (CLI)

Add to `.claude/settings.json` in your project or `~/.claude/settings.json` globally:

```json
{
  "mcpServers": {
    "pm-skills": {
      "command": "npx",
      "args": ["pm-skills-mcp"]
    }
  }
}
```

Cursor

Navigate to Settings → Features → MCP Servers, then add:

```json
{
  "pm-skills": {
    "command": "npx",
    "args": ["pm-skills-mcp"]
  }
}
```

Restart Cursor. The 40 PM skill tools will be available in AI chat (catalog frozen at the v2.9.2 build; see Maintenance Mode notice above).

GitHub Copilot (MCP-enabled)

Configure your Copilot MCP extension/integration with the same stdio server pattern:

```json
{
  "mcpServers": {
    "pm-skills": {
      "command": "npx",
      "args": ["pm-skills-mcp"]
    }
  }
}
```

If your Copilot surface does not currently expose MCP server configuration, use file-based
[pm-skills](https://github.com/product-on-purpose/pm-skills) with
[AGENTS.md](https://github.com/product-on-purpose/pm-skills/blob/main/AGENTS.md) as the fallback path.

OpenCode (MCP-enabled)

Use OpenCode's MCP server configuration with the standard `npx pm-skills-mcp` pattern:

```json
{
  "mcpServers": {
    "pm-skills": {
      "command": "npx",
      "args": ["pm-skills-mcp"]
    }
  }
}
```

If MCP is unavailable in your current OpenCode setup, use file-based
[pm-skills](https://github.com/product-on-purpose/pm-skills) and
[AGENTS.md](https://github.com/product-on-purpose/pm-skills/blob/main/AGENTS.md).

VS Code (Cline / Continue)

**With Cline:**
1. Install [Cline](https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev) from VS Code Marketplace
2. Open Cline settings and configure MCP server:
   ```json
   {
     "pm-skills": {
       "command": "npx",
       "args": ["pm-skills-mcp"]
     }
   }
   ```

**With Continue:**
1. Install [Continue](https://marketplace.visualstudio.com/items?itemName=Continue.continue) from VS Code Marketplace
2. Configure MCP in Continue settings

Other MCP Clients

Any MCP-compatible client can use pm-skills-mcp. The general pattern:

1. Configure an MCP server with command `npx` and args `["pm-skills-mcp"]`
2. Restart the client
3. All 40 PM skills become available as tools (catalog frozen at the v2.9.2 build; see Maintenance Mode notice above)

See the [Integration Guide](docs/integration-guide.md) for detailed instructions for all platforms.

### Configuration

#### Environment Variables

| Variable             | Default    | Description                     |
| -------------------- | ---------- | ------------------------------- |
| `PM_SKILLS_PATH`     | (embedded) | Path to custom skills directory |
| `PM_PERSONAS_PATH`   | (auto)     | Path to persona library resources |
| `PM_SKILLS_FORMAT`   | `full`     | Default output format           |
| `PM_SKILLS_INCLUDE_EXAMPLES` | `false` | Include examples by default |

#### Custom Skills Path

Override embedded skills with your customized versions:

```json
{
  "mcpServers": {
    "pm-skills": {
      "command": "npx",
      "args": ["pm-skills-mcp"],
      "env": {
        "PM_SKILLS_PATH": "/path/to/my/custom/skills"
      }
    }
  }
}
```

#### Using Custom Skills from a pm-skills Fork

If you've forked [pm-skills](https://github.com/product-on-purpose/pm-skills) to customize skills:

1. Clone your fork locally
2. Make changes to skills in `skills/{phase-skill}/` (e.g., `skills/deliver-prd/`)
3. Point pm-skills-mcp to your fork:

```json
{
  "mcpServers": {
    "pm-skills": {
      "command": "npx",
      "args": ["pm-skills-mcp"],
      "env": {
        "PM_SKILLS_PATH": "/path/to/my-pm-skills-fork/skills"
      }
    }
  }
}
```

See the [pm-skills authoring guide](https://github.com/product-on-purpose/pm-skills/blob/main/docs/guides/authoring-pm-skills.md) for skill modification guidelines.

(back to top)

---

## Usage

### How It Works

```
┌─────────────────────────────────────────────────────────────┐
│                    Your AI Assistant                        │
│              (Claude, Cursor, Continue, etc.)               │
└──────────────────────────┬──────────────────────────────────┘
                           │ MCP Protocol
                           ▼
┌─────────────────────────────────────────────────────────────┐
│                    pm-skills-mcp Server                     │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│   ┌─────────────┐   ┌─────────────┐   ┌─────────────┐       │
│   │   59 Tools  │   │  Resources  │   │  3 Prompts  │       │
│   │             │   │             │   │             │       │
│   │ • 40 skills │   │ • templates │   │ • kickoff   │       │
│   │ • 11 flo

…

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [product-on-purpose](https://github.com/product-on-purpose)
- **Source:** [product-on-purpose/pm-skills-mcp](https://github.com/product-on-purpose/pm-skills-mcp)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-product-on-purpose-pm-skills-mcp
- Seller: https://agentstack.voostack.com/s/product-on-purpose
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.