Architect
MCP App: turn any requirement into a hierarchical drill-down spec tree. 4 tools, interactive UI + Markdown fallback. First io.modelcontextprotocol/ui app.
Ask AI about Architect
Powered by Claude · Grounded in docs
I know everything about Architect. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
@vantageos/mcp-architect
Turn any high-level requirement into a structured visual spec/plan with hierarchical drill-down. First ElPi Corp MCP App, built on the
io.modelcontextprotocol/uistandard (stable 2026-01-26). Bilingual FR + EN.
About
Specs written as text walls are read once and abandoned. This MCP App makes them navigable.
@vantageos/mcp-architect is the first MCP App built on the io.modelcontextprotocol/ui standard (stable 2026-01-26). It decomposes any high-level requirement — a software system, a product plan, a process redesign — into a structured component tree your MCP client renders inline as an interactive drill-down. Clients without UI extension support receive the same data as clean, nested Markdown. No degradation either way.
What it does
Four tools with one shared mental model: decompose, visualize, drill deeper, export.
| Tool | What you get |
|---|---|
decompose_spec | A requirement string in, a full hierarchical component tree out. Domains: software, product, process, research. Depth 1-4. Bilingual via locale param. |
render_architecture | Render an existing tree in tree, graph, or matrix view. Called after decompose_spec or on demand. |
expand_node | Drill down further on any node. Triggered by clicking a node in the UI — calls the server via the bridge protocol. No page reload, no new prompt. |
export_spec | Export the current tree as markdown, json, or a mermaid diagram. One click from the UI ExportPanel, or call directly. |
Every tool returns dual content: a ui:// resource for UI-capable clients and a fallback Markdown block for all others. This is non-negotiable — mandated by Critical Rule #1 of the MCP App standard.
Who it is for
- Software architects and lead developers decomposing complex requirements before sprint planning
- Product managers who need structured specs their teams can navigate, not documents they have to search
- Technical teams running MCP-capable clients (Claude Desktop, VS Code Insiders, MCPJam, ChatGPT MCP) who want visual output instead of prose
Why this is different
No other MCP server returns an interactive UI component alongside its text output. This is the first implementation of io.modelcontextprotocol/ui (stable since 2026-01-26) as a shipped, tested product — not a demo. The UI bundle is 68 KB gzipped, WCAG AA compliant, and contains zero external runtime calls.
Quick Start
npx -y @vantageos/mcp-architect
Add to mcp.json:
{
"mcpServers": {
"vantage-architect": {
"command": "npx",
"args": ["-y", "@vantageos/mcp-architect"]
}
}
}
No API key. No account. Then ask: "Decompose the architecture of a multi-tenant SaaS with real-time collaboration."
Examples
Software architecture: Call decompose_spec with a microservices requirement at depth: 3. Get a tree with components, modules, and tasks. Click any node to expand it via expand_node.
Product planning: Use domain: "product" to break a product brief into features, dependencies, and open decisions — each node typed (feature, task, decision).
Export to Mermaid: Call export_spec with format: "mermaid" to get a diagram you paste directly into your technical spec document.
Doctrine Flexibilité — Phase 1 / Phase 2
Phase 1 (current): stdio transport, local install, single-file UI bundle (68 KB gzipped), no remote server, no auth required.
Phase 2 (planned): Remote MCP App demo via Railway, Pro tier, auth via Polar.sh. railway.json committed in repo for future activation. Activated based on adoption signal.
MIT License — Author: ElPi Corp / Laurent Perello — Source: github.com/elpiarthera/vantage-architect-mcp
Why
Specs and plans are usually returned as a wall of text. This MCP App returns them as an interactive component tree your client renders inline (Claude desktop, ChatGPT MCP, VS Code Insiders, MCPJam, …) with drill-down on every node. Clients without UI extension support fall back to a meaningful Markdown rendering — same data, no degradation.
Install
npx -y @vantageos/mcp-architect
Or in your mcp.json :
{
"mcpServers": {
"vantage-architect": {
"command": "npx",
"args": ["-y", "@vantageos/mcp-architect"]
}
}
}
Tools
| Tool | What it does |
|---|---|
decompose_spec | Decomposes a requirement into a hierarchical tree (software / product / process / research). |
render_architecture | Renders an existing tree as tree / graph / matrix. |
expand_node | Drill-down on a node (called by the UI via the bridge). |
export_spec | Exports as markdown / json / mermaid. |
Every tool returns dual content : a fallback markdown block + a ui:// resource (Critical Rule #1, no exception).
Quick example
await client.callTool("decompose_spec", {
requirement: "Build a multi-tenant document collaboration SaaS with real-time editing, comments, history.",
domain: "software",
depth: 3,
locale: "en"
});
In a UI-capable client, you get an interactive tree. In a plain text client, you get :
- **Build a multi-tenant document collaboration SaaS …** _(component)_ — Build …
- **Frontend** _(module)_ — Frontend — auto-decomposition (heuristic v1.0).
- …
Bilingual
Pass locale: "fr" to receive French node names + descriptions ; the UI also exposes a runtime EN/FR toggle (no localStorage, sandbox-safe).
Development
npm install
npm test # 26 tests across 10 files (16 server + 8 component + 1 integration + 1 a11y)
npm run build # server bundle (tsup)
npm run build:ui # UI single-file bundle (vite + vite-plugin-singlefile)
npm run evals # run evals/evals.json (16 cases)
Build & evals order
Run npm run build before npm run evals (or rely on the tsx fallback in scripts/run-evals.js). The evals harness imports built artifacts when present and falls back to live TS execution via tsx otherwise.
Standards & doctrine
- MCP server standard : ElPi Corp
mcp-standard.mdv1. - MCP App standard : ElPi Corp
mcp-app-standard.mdv1 (10 Critical Rules). - UI extension :
io.modelcontextprotocol/uistable 2026-01-26. - Doctrine Flexibilité 5/5 : two alternatives documented in
docs/architecture.md(Next.js web app ; Markdown export).
License
MIT © 2026 ElPi Corp / Laurent Perello
Built by: mcp-server-builder + mcp-apps-ui-builder (via gamma) | bu-mcp BU | 2026-04-26
