The Azure Architecture Diagram Builder just grew up. It now iterates by conversation, sketches whiteboard-style blueprints, runs a 13-model fleet — and, most importantly, exposes itself as an MCP server that AI agents like Microsoft Scout can call directly.
AZURE ARCHITECTURE BLOG · 8 MIN READ
Author: Arturo Quiroga, Senior Partner Solutions Architect — Microsoft
Two months ago I published From Prompt to Production: Building Azure Architecture Diagrams with AI, introducing the open-source Azure Architecture Diagram Builder. The response was humbling — thousands of you read it, tried the tool, and filed issues and feature requests. A follow-up on how the Well-Architected Framework scoring works went deep on validation.
You asked, and the tool grew. This post is about what’s new since May — and one change big enough to reframe the whole project: the Azure Architecture Diagram Builder is no longer just an app you click. It’s a partner you chat with, and a tool other agents can call.
TL;DR. Three arcs of new capability: (1) Architecture Chat turns diagram design into a multi-turn conversation over the live canvas; (2) Blueprint Diagrams produce hand-drawn, whiteboard-style deliverables alongside the formal topology; and (3) the app now exposes its capabilities as a Model Context Protocol (MCP) server, so AI agents can generate, validate, cost, and render Azure architectures programmatically. Plus a 13-model fleet, deployment guides grounded in Microsoft Learn, and July output enhancements.
What’s new at a glance
| Capability |
What it does |
|---|---|
| Architecture Chat |
Refine a diagram by conversation — “add Front Door with WAF,” then“now make it zone-redundant.” Each turn reads the live canvas and auto-saves to history. |
| Blueprint Diagrams (BETA) |
Hand-drawn, whiteboard-style renders with nested zones and numbered flow arrows. Topology, Blueprint, or Both. |
| A fleet of 13 models |
Multi-provider roster — GPT-5.x, DeepSeek, Grok, Mistral, and Kimi — with side-by-side comparison to pick the right brain per task. |
| MCP server |
The app is now a remote MCP server. Agents can list_services, validate_architecture, estimate_costs, generate_bicep and render_diagram with typed, structured outputs. |
| Microsoft Learn grounding |
Deployment guides now cite live Microsoft Learn documentation. |
| Output enhancements (July 2026) |
Cost badges, light/dark render themes, and metadata panels in rendered diagrams. |
From clicking to conversing: Architecture Chat
The single most common request after the launch post was some version of “I love the first diagram, but I want to iterate without re-writing the whole prompt.” Regenerating from scratch every time you tweak a requirement is slow and loses context.
Architecture Chat solves this. It’s a conversational panel that sits alongside the canvas and treats your diagram as a living document. Each message is a turn in an ongoing design session:
- “Add an Azure Front Door with WAF in front of the app tier.”
- “Now make the data layer zone-redundant.”
- “Swap the SQL Database for Cosmos DB and update the connections.”
Every turn reads the current state of the canvas — not the original prompt — so refinements compound naturally the way they would with a human architect at a whiteboard. The conversation auto-saves to history, so you can step back through the evolution of a design or branch from an earlier point.
Figure 1. Architecture Chat treats the diagram as a living document. Each message refines the current canvas — adding services, changing SKUs, or reorganizing groups — and the full exchange is saved to history.
The shift is subtle but important: architecture design stops being a one-shot prompt and becomes an iterative dialogue.
The whiteboard deliverable: Blueprint Diagrams (BETA)
Formal topology diagrams with official Azure icons are perfect for documentation and stakeholder decks. But early-stage design conversations often want something looser — the hand-drawn feel of a whiteboard sketch that communicates intent without implying finality.
Blueprint Diagrams generate exactly that: a whiteboard-style render with nested zones (subscription → VNet → subnet), numbered flow arrows, and a deliberately sketchy aesthetic. You choose the output mode:
- Topology — the formal, icon-based diagram from the launch post
- Blueprint — the hand-drawn whiteboard style
- Both — generate the two side by side
Figure 2. The same architecture in two visual languages. Left: the formal, icon-based topology. Right: Blueprint mode — a whiteboard-style render with nested zones and numbered flow steps, plus a numbered legend explaining each hop. Use Blueprint for early design conversations and Topology for final documentation.
It’s the same underlying architecture — two visual languages for two different moments in the design lifecycle.
A fleet of 13 models: pick the right brain per task
The launch post shipped with multi-model support. That fleet has grown to 13 models across five providers, so you can match the model to the job — fast models for iteration, reasoning models for complex designs, code-optimized models for Bicep generation:
- OpenAI GPT-5.x — GPT-5.1, GPT-5.2, GPT-5.2 Codex, GPT-5.3 Codex, GPT-5.4, GPT-5.4 Mini
- DeepSeek — V3.2 Speciale, V4 Pro
- xAI Grok — 4.1 Fast, 4.3
- Mistral — Large 3
- MoonshotAI Kimi — K2.5, K2.7 Code
The Compare Models feature runs the same prompt through any subset of these in parallel and ranks them on service count, token usage, latency, and cost — with Fastest / Cheapest / Most Thorough badges — so you can make an evidence-based choice rather than a guess.
Figure 3. Multi-model comparison across the full 13-model fleet. Top: the results grid ranks every model on service count, connections, token usage, latency, and cost, with Fastest / Cheapest / Most Thorough badges. Bottom: an optional AI Critique uses a critic model to rank the outputs and explain each model’s strengths and gaps.
Adding a model is now a small, well-understood change — a testament to how the multi-provider abstraction has matured since May.
The headline: the Diagram Builder is now an MCP server
Here’s the change that reframes the project. Everything above is about a person using a web app. But the same capabilities — generating a diagram, validating it against WAF, estimating its cost, producing Bicep — are exactly the things an AI agent needs when it reasons about Azure architecture.
So we exposed them. The Azure Architecture Diagram Builder now runs as a Model Context Protocol (MCP) server. Any MCP-capable agent can call its tools with typed inputs and structured outputs:
| Tool |
What the agent gets |
|---|---|
list_services |
The catalog of supported Azure services and categories |
validate_architecture |
A WAF assessment with pillar scores and findings |
estimate_costs |
Multi-region cost estimates from the Azure Retail Prices API |
generate_bicep |
Infrastructure-as-Code templates for the design |
render_diagram |
A rendered diagram (topology or blueprint) of the architecture |
This means an agent can hold a conversation like “design a HIPAA-compliant platform, check it against the Well-Architected Framework, tell me the monthly cost in West Europe, and give me the Bicep” — and the Diagram Builder answers each part programmatically, returning structured data the agent can reason over and chain.
Figure 4. The Diagram Builder as an MCP server inside Microsoft Scout. Top: from a natural-language request, the agent calls the
render_diagramtool with structured parameters (title, format, direction, theme, region) and saves the returned SVG to its workspace. Bottom: the rendered architecture — grouped zones, labeled flows, and cost badges — appears inline in the conversation, generated entirely through agent tool calls.
The tool that started as a canvas for humans is now also a building block for agents. That’s the arc: from an app you click, to a partner you chat with, to a tool other agents call.
Grounded in Microsoft Learn, and sharper output
Two smaller-but-meaningful improvements round out the release:
- Microsoft Learn grounding. Deployment guides now search official Microsoft Learn documentation at generation time and cite it, so the guidance reflects current, authoritative practice rather than a model’s training snapshot.
- Output enhancements (July 2026). Rendered diagrams now carry per-service cost badges, support light and dark render themes, and include metadata panels that summarize the architecture — service counts, regions, and estimated cost — directly on the image.
Highlights
Since the May launch, the Azure Architecture Diagram Builder has grown from a design tool into an agent-ready platform:
- Conversational design: iterate on a diagram by chatting over the live canvas, with full history
- Two visual languages: formal topology and hand-drawn Blueprint, from the same architecture
- 13 models, five providers: choose the right brain per task, with evidence-based comparison
- Agent-ready: an MCP server exposing generation, validation, costing, and IaC as callable tools
- Grounded guidance: deployment guides cite live Microsoft Learn documentation
- Still open source: every capability above is available to inspect, extend, and contribute to
Try It Today
- Live demo: https://aka.ms/diagram-builder
- Source code: GitHub repository
- Documentation: See the Getting Started Guide for setup, and the repository’s MCP server directory for agent integration.
If you read the first post and tried the tool — thank you. The features above exist because you told me what you needed. Keep the feedback coming via GitHub Issues.
Tags: artificial intelligence · application · apps & devops · well architected · infrastructure
Microsoft