AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

azure-app-onboard

End-to-end orchestrator: from a business idea, app idea, or existing app to running Azure deployment with cost estimates and pre-deploy approval. Analyzes your app, auto-detects the right Azure services, scaffolds infrastructure code, and deploys — tailored to your app, not a template. Handles moving existing apps to Azure without rewriting or with minimal changes. WHEN: bring your app to Azure, plan my app, cost to run, is my code ready to deploy, deploy my app to the cloud, deploy all my services, what Azure services do I need, plan my Azure deployment, deploy my new app to Azure, one-click deploy, I have an app and want it on Azure, migrate my app to Azure, help me get started, build an app, no code yet, starter project. DO NOT USE FOR: use azd for deployment(use azure-deploy), optimizing existing costs (use cost-optimization), code readiness checks only (use azure-app-onboard-prereq).

Original source
microsoft
License
MIT
Pinned revision
3f5b461b2314e01c400564051e92469114c5b68f

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read microsoft--azure-app-onboard at revision 3f5b461b2314e01c400564051e92469114c5b68f, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 11

references/mcp-tool-reference.md

MCP Tool Reference — Shared Index

Shared tools used across multiple AppOnboard phases, plus the cross-cutting Phase→Tool Map. For phase-specific tools with full parameter tables, see the per-phase references linked below.

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

Per-Phase Tool References

| Phase | File | Exclusive Tools | |-------|------|-----------------| | Prereq | (shared tools only — see table below) | (shared only) | | Prepare | mcp-tools.md | pricing, quota, cloudarchitect, WAF, advisor, group_resource_list, policy | | Scaffold | mcp-tools.md | bicepschema, all mcp_bicep_*, deploy (iac_rules/pipeline/plan), terraform best practices | | Deploy | mcp-tools.md | resourcehealth, monitor, appservice, deploy (app_logs/arch_diagram), role |


Global Parameters (all tools)

Every Azure MCP tool accepts these optional parameters in addition to its own:

| Parameter | Description | |-----------|-------------| | subscription | Azure subscription ID or display name. Defaults to az account show default. | | tenant | Entra ID tenant GUID or name. Uses default tenant if omitted. | | resource-group | Resource group name. Required for most resource-specific operations. |

Additional global params (not commonly needed by AppOnboard): authentication-method (credential|key|connectionString), max-retries (default 3), retry-delay (default 2s), retry-delay-maximum (default 10s), retry-mode (fixed|exponential), retry-network-timeout (default 100s). See official docs for details.


Shared Tools (used by 2+ phases)

mcp_azure_mcp_subscription_list

| Required | Optional | Read-Only | |----------|----------|-----------| | (none) | tenant | ✅ |

Returns: subscriptionId, displayName, state, tenantId, isDefault. Use isDefault: true as default subscription.

Used by: prepare (Step 1), deploy (Step 1)

mcp_azure_mcp_group_list

| Required | Optional | Read-Only | |----------|----------|-----------| | (none) | subscription, tenant | ✅ |

Returns: resource group names and IDs as JSON array.

Used by: prepare (Step 7), deploy (Step 3)

mcp_azure_mcp_extension_cli_install

| Required | Optional | Read-Only | |----------|----------|-----------| | cli-type (az|azd|func) | tenant | ✅ |

Returns: installation instructions for the specified CLI tool.

Used by: prereq (Step 2), deploy (Step 3)

mcp_azure_mcp_get_azure_bestpractices (hierarchical)

| Sub-command | Required Params | Optional Params | Read-Only | |-------------|----------------|-----------------|-----------| | get_azure_bestpractices_get | resource (general|azurefunctions|static-web-app|coding-agent), action (all|code-generation|deployment) | — | ✅ | | get_azure_bestpractices_ai_app | (none) | — | ✅ |

Usage: resource + action are both required for _get. For static-web-app and coding-agent, only action: "all" is supported.

Used by: prereq (Step 3), scaffold (Step 5)


Tool Pitfalls

  • mcp_azure_mcp_subscription_list is slow at scale: Returns ALL subscriptions across ALL tenants (238+ in large orgs), causing lengthy picker detours. Use az account show for the active subscription (<1 second). Reserve subscription_list for prepare Step 1 when the user explicitly wants a different subscription.