MCP server

Tool reference

Every tool of Brunel's MCP server with its parameters, types and constraints, and whether it reads or writes. Generated from the server's own tool definitions.

Generated from the definitions the MCP server publishes in tools/list. Tools marked read-only can be called with a read-only key.

whoamiread-only

Account

The Brunel account behind this key: login, plan and the key's scope.

No parameters.

list_projectsread-only

List projects

The account's analyses (one per repository conversation), most recent first.

NameTypeDescription
limitintegermin 1, max 100, default 20

analyze_repositorywrites

Analyze a repository

Read a GitHub repository and return what it runs (languages, frameworks, datastores, queues…) with file evidence, its services, a security check and a suggested context for design_infrastructure. Takes 5 to 60 seconds.

NameTypeDescription
repoUrlrequiredstringGitHub URL or owner/repo≥ 1 chars, ≤ 500 chars
refstringBranch, tag or commit (default branch when omitted)≤ 200 chars

design_infrastructurewrites

Design the infrastructure

Design four priced production tiers (starter, growth, scale, enterprise) for an analyzed repository. Every field of the context is optional: missing ones come from the suggested context.

NameTypeDescription
conversationIdrequiredstring≥ 1 chars, ≤ 40 chars
contextobjectpeakRps, monthlyActiveUsers, dataVolumeGb, monthlyBudgetEur, opsSkill (none|basic|strong), availability (99|99.9|99.95), compliance (gdpr, health, pci…), providers (aws|scaleway), region

get_architectureread-only

Get the architecture

The current state of a project: facts, security check and, once designed, the four priced tiers with their components.

NameTypeDescription
conversationIdrequiredstring≥ 1 chars, ≤ 40 chars

refine_architecturewrites

Refine by asking

Ask a question about the architecture or request a change ("make it cheaper", "add a staging environment", "switch to Scaleway"). A change creates a new version; the answer and the new tiers are returned.

NameTypeDescription
conversationIdrequiredstring≥ 1 chars, ≤ 40 chars
messagerequiredstring≥ 1 chars, ≤ 4000 chars
focusTier"starter" | "growth" | "scale" | "enterprise"default "growth"

get_filesread-only

Get the generated files

The deployable files of one tier: Terraform, Kubernetes or Compose, CI workflow, runbook and decision records. Pass a path to get one file's content.

NameTypeDescription
conversationIdrequiredstring≥ 1 chars, ≤ 40 chars
tier"starter" | "growth" | "scale" | "enterprise"default "growth"
versionintegermin 1, max 9007199254740991
pathstring≤ 300 chars
Tool reference · Brunel Docs