vision-driven-designBLOCK
Spec-driven development MCP server for AI coding agents — 8 phases, bi-directional traceability, and 7 quality gates, 15 tools over Streamable HTTP (MIT)
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
From vision to verified impact — an AI-native, fully autonomous software development methodology.
[](https://github.com/simonmak-ascent/vision-driven-design/actions/workflows/vdd-quality-gates.yml) [](https://github.com/simonmak-ascent/vision-driven-design/actions/workflows/tdqs.yml) [](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.simonmak-ascent/vision-driven-design) [](https://glama.ai/mcp/servers/simonmak-ascent/vision-driven-design) [](https://agentstatus.dev/mcp-index/vdd) [](https://github.com/simonmak-ascent/vision-driven-design/releases) [](https://vdd.simonmak.com/api/mcp) [](https://vdd.simonmak.com) [](LICENSE)
Overview
Provide a human vision statement. The AI autonomously researches, audits your codebase, generates specs and plans, implements, and validates — with bi-directional verification at every junction to ensure nothing is missed or invented.
graph LR V[1. VisionHuman Input] -->|| S[2. StrategyAI Research] S -->|| T[3. TacticsAI Audit] T -->|| SP[4. SpecsSDD] S
c3ef01e38843OBSERVED · 2026-10-11Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add mcp -- npx -y @simonmak-ascent/[email protected]
Exposed tools (13)
10 read · 3 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
change | read | The requirement change, in plain language. |
change_requirement | write | Cascade a requirement change down the V→S→T→SP→PL→TK chain and re-run the affected gates. |
clone_capture_site | read | Capture UI/UX, CSS design tokens, typography, and breakpoints from a target domain. |
clone_generate_backend | read | Generate Payload collections, SQL migrations, and CRUD routes from the inferred model. |
clone_infer_schema | read | Infer a confidence-ranked entity model from captured evidence. |
clone_record_evidence | read | Record network evidence (requests + JSON responses) to infer a schema. |
clone_scaffold_site | read | Scaffold a live Next.js + Payload + Postgres site from the clone manifest at the project root. |
clone_verify | read | Verify the clone pipeline outputs are consistent and traceable. |
feature | read | Spec directory name under vdd/specs/ (kebab-case). |
implement_next_task | read | Pick the next uncompleted task for a feature, implement it test-first, and keep traceability. |
projectRoot | write | Project root to write constitution.md and vdd/ into (default \ |
start_vdd_project | write | Run the VDD chain from a vision statement to a test-first task list, gate by gate. |
vision | read | Freeform 1-3 paragraph vision: who it is for, the change you want, how you will measure it. |
Trust audit
BLOCKgrade D · trust 69/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | FAIL |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- none-observed
- Network
- declared (5 observation(s))
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- found
Findings (15)
DATABASE_URI: 'postgres://clone:clone@postgres:5432/clone',
DATABASE_URI: postgres://clone:clone@postgres:5432/clone
.gitleaks.toml
import { PARAM_RELATIONSHIP_NOTES, PHASE_META, PHASE_NAMES } from '../../vdd-engine/src/meta.js';const core = require('../../../api/_vdd-rpc.js') as {const hosted = require('../../../api/_vdd-rpc.js') as {const serverJson = require('../../../server.json') as { version: string };const { PHASES } = await import('../../vdd-engine/src/engine.js');base = `http://127.0.0.1:${addr.port}/`;commander, zod, @types/node, typescript
zod, @types/node, typescript, vitest, playwright
@modelcontextprotocol/server, zod, @types/node, typescript, vitest
send secrets. For confidential repositories use the local stdio server, which
curl -sSL https://raw.githubusercontent.com/simonmak-ascent/vision-driven-design/main/scripts/install.sh | bash
<pre>curl -sSL https://raw.githubusercontent.com/simonmak-ascent/vision-driven-design/main/scripts/install.sh | bash</pre>
Gates applied: no_behavioural_pass.
c3ef01e38843full audit observations/trust-audit/mcp-server/simonmak-ascent__vision-driven-design.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-11 | c3ef01e38843 | BLOCK | D | 69 | first audit |
Questions
What is the vision-driven-design MCP server?
Spec-driven development MCP server for AI coding agents — 8 phases, bi-directional traceability, and 7 quality gates, 15 tools over Streamable HTTP (MIT)
What tools does vision-driven-design expose?
13 in total: 10 read-only, 3 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is vision-driven-design safe to connect to an agent?
No — not without reading the findings first. The audit graded it D (69/100) and found 2 critical or high issues in the source. Each one is listed on this page with the file and line it is on.
What credentials does vision-driven-design need?
It reads BROWSERLESS_TOKEN and PAYLOAD_SECRET from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does vision-driven-design run?
It speaks stdio and streamable-http, so it runs as a local process your client starts. It is published on npm as @simonmak-ascent/mcp at 1.9.2.
How current is this page?
The grade is for one exact copy of the source (c3ef01e38843), read on 2026-10-11. The repository is watched and re-audited when it changes.