Scaffold Phase — MCP Tools

Phase-exclusive tool parameters for the scaffold phase. For shared tools (get_azure_bestpractices, subscription_list, group_list, extension_cli_install), see mcp-tool-reference.md.

Troubleshooting: If a tool call fails with unknown parameter or missing command errors, consult the official docs: https://learn.microsoft.com/en-us/azure/developer/azure-mcp-server/tools/

Azure MCP Tools — `mcp_azure_mcp_*`

`mcp_azure_mcp_deploy` (hierarchical)

Sub-command	Required Params	Optional Params	Read-Only
`deploy_plan_get`	`workspace-folder`, `project-name`, `target-app-service` (ContainerApp\|WebApp\|FunctionApp\|AKS), `provisioning-tool` (AzCli\|AZD), `source-type` (from-project\|from-azure\|from-context), `deploy-option` (provision-and-deploy\|deploy-only\|provision-only)	`iac-options` (bicep\|terraform), `resource-group`	✅
`deploy_iac_rules_get`	`deployment-tool` (AzCli\|AZD)	`iac-type` (bicep\|terraform), `resource-types` (comma-sep: appservice, containerapp, function, aks, azuredatabaseforpostgresql, azuredatabaseformysql, azuresqldatabase, azurecosmosdb, azurestorageaccount, azurekeyvault)	✅
`deploy_pipeline_guidance_get`	`is-azd-project` (bool), `pipeline-platform` (github-actions\|azure-devops), `deploy-option` (deploy-only\|provision-and-deploy)	subscription, tenant	✅

`mcp_azure_mcp_bicepschema` (hierarchical)

Sub-command	Required Params	Optional Params	Read-Only
`bicepschema_get`	`resource_type` (e.g. Microsoft.Web/sites)	`api_version`	✅

Usage: ARM resource type schemas. Primary tool for scaffold — returns resource properties, required fields, and constraints. Prefer over mcp_bicep_get_az_resource_type_schema when you need a quick schema lookup without specifying an exact API version.

`mcp_azure_mcp_azureterraformbestpractices` (flat)

Required	Optional	Read-Only
(none)	`resource_type` (e.g. "azurerm_linux_web_app")	✅

Usage: Returns Terraform best practices for Azure resources. Omit resource_type for general guidance. Provide resource_type to get resource-specific azurerm configuration patterns, recommended properties, and security settings. Used during scaffold Step 5 for per-resource HCL generation (Terraform path only).

Bicep MCP Tools — `mcp_bicep_*`

`mcp_bicep_get_bicep_best_practices`

Required	Optional	Read-Only
(none)	—	✅

Returns: comprehensive best practices for Bicep authoring (naming, organization, parameters, security, testing).

`mcp_bicep_get_az_resource_type_schema`

Required	Optional	Read-Only
`azResourceType` (e.g. Microsoft.KeyVault/vaults), `apiVersion` (e.g. 2024-11-01)	—	✅

Returns: complete JSON schema for the resource type including all properties, nested types, constraints.

`mcp_bicep_list_avm_metadata`

Required	Optional	Read-Only
(none)	—	✅

Returns: metadata for all Azure Verified Modules (AVM) including versions and docs.

`mcp_bicep_list_az_resource_types_for_provider`

Required	Optional	Read-Only
`providerNamespace` (e.g. Microsoft.Compute)	—	✅

Returns: all resource types and API versions for the provider.

`mcp_bicep_build_bicep`

Required	Optional	Read-Only
`filePath` (absolute)	—	✅

Returns: compiled ARM template JSON + compilation errors, warnings, info for a .bicep file.

`mcp_bicep_format_bicep_file`

Required	Optional	Read-Only
`filePath` (absolute)	—	❌

Formats the Bicep file per official standards. Respects bicepconfig.json.

`mcp_bicep_get_deployment_snapshot`

Required	Optional	Read-Only
`filePath` (absolute, `.bicepparam`)	—	✅

Returns: deployment snapshot from a Bicep parameters file — resolves all parameter values and template references into a single deployable payload. Useful for pre-deploy validation.

`mcp_bicep_get_file_references`

Required	Optional	Read-Only
`filePath` (absolute, `.bicep` or `.bicepparam`)	—	✅

Returns: all file references (modules, parameters, imports) from a Bicep file. Useful for dependency analysis and verifying scaffold output completeness.

`mcp_bicep_decompile_arm_template_file`

Required	Optional	Read-Only
`filePath` (absolute, .json/.jsonc/.arm)	—	❌

Converts ARM JSON → Bicep. Best-effort; may need manual review.

`mcp_bicep_decompile_arm_parameters_file`

Required	Optional	Read-Only
`filePath` (absolute, .json/.jsonc/.arm)	—	❌

Converts ARM parameters JSON → .bicepparam.

Phase 3 Tool Map

Tool	Sub-command	AppOnboard Step	Purpose
`mcp_bicep_get_bicep_best_practices`	(flat)	Step 5	Primary — Bicep conventions, naming, module patterns for IaC generation
`mcp_bicep_get_az_resource_type_schema`	(flat)	Step 5	Primary — ARM resource type JSON schema per service for property validation
`mcp_bicep_list_avm_metadata`	(flat)	Step 5	Primary — AVM module catalog; prefer verified modules over raw resource definitions
`mcp_azure_mcp_bicepschema`	`bicepschema_get`	Step 5	Primary — ARM resource type schemas without requiring exact API version
`mcp_azure_mcp_deploy`	`deploy_iac_rules_get`	Step 5	IaC best practices and rules. `--iac-type bicep` (default) or `--iac-type terraform`
`mcp_azure_mcp_get_azure_bestpractices`	`get_azure_bestpractices_get`	Step 5	SDK patterns during IaC gen. `resource: "general"`, `action: "code-generation"`
`mcp_bicep_build_bicep`	(flat)	Step 9	Primary — validate generated `.bicep` files in self-review L3 (syntax, properties, API versions)
`mcp_bicep_format_bicep_file`	(flat)	Step 9	Format generated `.bicep` files per official standards after self-review fixes
`mcp_bicep_get_file_references`	(flat)	Step 11	Verify scaffold output completeness — all module references resolve
`mcp_azure_mcp_deploy`	`deploy_pipeline_guidance_get`	Step 10	CI/CD pipeline config. `is-azd-project: false`, `pipeline-platform: "github-actions"`, `deploy-option: "provision-and-deploy"`
`mcp_azure_mcp_deploy`	`deploy_plan_get`	Step 12	Structured deployment plan as validation input. Set `source-type: "from-project"`, `target-app-service` from plan
`mcp_azure_mcp_azureterraformbestpractices`	(flat)	Step 5	Terraform path only — patterns and conventions for HCL generation

/azure-app-onboard

scaffoldreferencesmcp-tools.md