GenSpec MCP Server

MCP server for GenSpec workflow - converts USER-STORIES.md into README, ROADMAP, and SYSTEM-ARCHITECTURE documents

Local serverstdioTypeScript

What is the GenSpec MCP Server?

MCP server for GenSpec workflow - converts USER-STORIES.md into README, ROADMAP, and SYSTEM-ARCHITECTURE documents

What it actually does

A Model Context Protocol (MCP) server that converts user stories into structured documentation including README, ROADMAP, and SYSTEM-ARCHITECTURE documents through a guided approval workflow.

GenSpec MCP Server streamlines the documentation creation process by taking user stories as input and generating three key documentation artifacts:

  • MCP Integration — - Works seamlessly with Claude Desktop, VS Code with MCP extension, and Cursor
  • Template-Based Generation — - Uses predefined templates for consistent documentation structure
  • Approval Workflow — - Generate → Present → Approve/Edit cycle for each document
  • Phase Dependencies — - ROADMAP requires README, SYSTEM-ARCHITECTURE requires both
  • Multiple Entry Points — - Start from any phase or run the complete workflow
  • Resource Access — - Exposes templates via MCP resource protocol

Configuration

  • Node.js 18.0.0 or higher - npm or yarn package manager

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
start_genspecRun full workflow: README → ROADMAP → SYSTEM-ARCHITECTURE
generate_readmeGenerate README, then continue through ROADMAP → SYSTEM-ARCHITECTURE
generate_roadmapGenerate ROADMAP, then continue through SYSTEM-ARCHITECTURE
generate_architectureGenerate only SYSTEM-ARCHITECTURE

How to install the GenSpec MCP Server

{
  "mcpServers": {
    "genspec": {
      "command": "npx",
      "args": [
        "genspec-mcp"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Node.js 18.0.0 or higher - npm or yarn package manager

Example prompts to try

  • “Use GenSpec MCP to start genspec.”
  • “Use GenSpec MCP to generate readme.”
  • “Use GenSpec MCP to generate roadmap.”

Frequently asked questions

MCP server for GenSpec workflow - converts USER-STORIES.md into README, ROADMAP, and SYSTEM-ARCHITECTURE documents Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.