# Vision Driven Design (VDD) MCP Server

> Vision Driven Design (VDD) MCP Server is an open-source MCP server for design and media. Spec-driven methodology for coding agents: 8 phases, 7 traceability gates, 15 tools. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Website:** https://vdd.simonmak.com
- **Repository:** https://github.com/simonmak-ascent/vision-driven-design/tree/HEAD/packages/vdd-mcp
- **MCP Registry name:** com.ascent-partners/vision-driven-design
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-15

## About

Vision Driven Design asks for one human input, a vision statement, and then has the agent research, audit the codebase, write specs and plans, implement and validate. Work moves through eight phases from vision to strategy, tactics, specs, plan, tasks, implementation and validation, each producing a file such as `vision.md`, `spec.md` or `impact-report.md`.

The core idea is traceability in both directions. Seven gates, 108 checks in all, verify each junction so nothing is missed or invented. The README builds on Goldratt's strategy-and-tactic decomposition, and the site says it aligns with DO-178C, IEC 62304 and CMMI.

The server offers 15 tools over Streamable HTTP at a hosted endpoint with open access and no API key, or over stdio via the @simonmak-ascent/mcp npm package. Slash commands such as `/vdd:init`, `/vdd:vision` and `/vdd:e2e` run the chain. A constitution file can switch it to a gated mode that adds human approvals.

## Features

- **Eight-phase chain:** Vision, strategy, tactics, specs, plan, tasks, implement and validate, each with an output document.
- **Bi-directional gates:** Seven gates with 108 checks verify both directions at every junction.
- **Project constitution:** Immutable project rules generated at the start of a project.
- **Gated mode:** A constitution setting adds human approval points.
- **Impact report:** Final validation checks drift and verifies impact.
- **Hosted or local:** Use the keyless remote endpoint or the npm stdio package.

## Good for

- Turn a one-line product vision into specs and a task plan
- Audit a codebase before planning changes
- Keep tasks traceable back to requirements
- Run an end-to-end build with one command
- Add review gates for regulated or safety-minded projects

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http vision-driven-design https://vdd.simonmak.com/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://vdd.simonmak.com/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "vision-driven-design": {
      "url": "https://vdd.simonmak.com/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "vision-driven-design": {
      "type": "http",
      "url": "https://vdd.simonmak.com/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "vision-driven-design": {
      "serverUrl": "https://vdd.simonmak.com/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "vision-driven-design": {
      "type": "http",
      "url": "https://vdd.simonmak.com/api/mcp"
    }
  }
}
```

## FAQ

### Do I need an API key?

No. The hosted endpoint is open with no key.

### What license is it under?

MIT.

### How many tools does it expose?

15, over Streamable HTTP.

### Can humans approve steps?

Yes, adding VDD Mode: Gated to the constitution turns on human gates.

### Is Vision Driven Design (VDD) MCP Server free?

Yes. Vision Driven Design (VDD) MCP Server is open source, so you can use and self-host it for free.

### How do I add Vision Driven Design (VDD) MCP Server to Claude Code?

Run this command in your terminal: claude mcp add --transport http vision-driven-design https://vdd.simonmak.com/api/mcp

### What are the best alternatives to Vision Driven Design (VDD) MCP Server?

The closest alternatives to Vision Driven Design (VDD) MCP Server are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/vision-driven-design-vdd-mcp-server
