Get started
Brunel documentation
Everything Brunel does, precisely. From a GitHub repository to a priced, validated production infrastructure, with the REST API, the MCP server and the enterprise controls.
Brunel is an AI infrastructure architect. You paste a GitHub repository; Brunel reads the code, tells you what it runs with the file that proves each fact, designs its production infrastructure in four tiers priced from the cloud providers' official catalogs, and generates validated Terraform, CI workflows and documentation.
Start here
- Quickstart: analyze a repository and get four priced architectures in about two minutes.
- Core concepts: projects, facts, context, tiers, versions and the rules that keep designs honest.
- Plans and limits: what each plan includes, generated from the plan catalog.
What Brunel does
| Step | What happens | Read more |
|---|---|---|
| Analyze | The repository is downloaded read-only and 16 deterministic detectors extract facts, each with its evidence | Facts and evidence |
| Check | Known vulnerable dependencies, committed secrets, Dockerfile, CI and existing IaC risks | Security check |
| Design | Four complete tiers covering eight domains, mapped to real AWS or Scaleway services | Architecture tiers |
| Price | Unit prices from the official catalogs, every line shown with its catalog date | How prices are computed |
| Refine | Ask in plain language; every change is a new version with a diff and a cost delta | Refine |
| Generate | Terraform per domain, Kubernetes or Compose, GitHub Actions, runbook and ADRs, all validated | Generated files |
| Operate | Re-analysis on every push, pull request reviews, price watch, deployment through your CI | Real-time tracking |
| Prove | Signed reliability certificates anyone can verify | Reliability certificates |
Build on Brunel
- REST API: the same actions as the app over HTTPS, authenticated with an API key.
- MCP server: let Claude Code, Cursor, VS Code, Windsurf or any MCP client use Brunel as a tool.
- Webhooks: signed events for tracking alerts, pull request reviews, deployments and more.
Principles you can rely on
- Evidence first. Every detected fact links to the file and line that proves it, and you can correct any of them.
- Deterministic where it matters. Detection, mapping, pricing, validation and file generation are code, not AI output.
- Your CI, your credentials. Deployment runs in your GitHub Actions; Brunel never stores cloud keys.
- Untrusted input stays data. Repository content is wrapped as data for the AI, which has no tools and cannot follow instructions found in code.
Where things live
| Address | What it is |
|---|---|
| https://brunel.cloud | The product: chat, analyses, designs |
| https://console.brunel.cloud | Platform: API keys, MCP, usage, logs, webhooks, certificates |
| https://enterprise.brunel.cloud | Enterprise: members, security and SSO, audit log, billing |
| https://portal.brunel.cloud | Programs for startups, education, open source and partners |
| https://api.brunel.cloud | REST API (/v1) and MCP server (/mcp) |
| https://docs.brunel.cloud | This documentation |