1# Azure Functions Templates
2 
3Dynamic template selection for Azure Functions projects.
4 
5## Prerequisites: Check MCP Availability
6 
7Before proceeding, verify Azure MCP Server and Functions tools are available:
8 
9```
10functions_template_get(language: "python")
11```
12 
13| Result | Action |
14|--------|--------|
15| ✅ Returns template list | Use **Primary Path: MCP Tools** below |
16| ❌ Tool not found / Error | Jump to **[Fallback (MCP Unavailable)](#fallback-mcp-unavailable)** |
17 
18---
19 
20## Primary Path: MCP Tools
21 
22**Use Azure MCP tools** — they provide complete, up-to-date AZD templates with IaC, RBAC, and managed identity.
23 
24### Step 1: Discover Templates
25 
26```
27functions_template_get(language: "<python|csharp|typescript|javascript|java|powershell>")
28```
29 
30Returns template list with metadata:
31 
32- `templateName` — pass to generate call
33- `description` — use for selection (describes trigger, bindings, security features)
34- `resource` — filter by trigger type (http, cosmos, timer, eventhub, blob, sql, mcp, ai)
35- `infrastructure` — prefer `bicep` (default), use `terraform` if user requests
36 
37### Step 2: Select Template
38 
39Use the intent→resource mapping in [selection.md](selection.md) to map user intent to a `resource` filter value.
40 
41> **Default behavior:** When user intent cannot be determined or no trigger type is known, use `http` as the default.
42 
43**Single-template optimization:** If description mentions BOTH trigger AND binding user needs, fetch that one template only.
44 
45**IaC selection:**
46 
47- Default: `infrastructure: "bicep"`
48- If user says "terraform": `infrastructure: "terraform"`
49 
50### Step 3: Generate Project
51 
52```
53functions_template_get(
54  language: "<language>",
55  template: "<selected-template-name>"
56)
57```
58 
59### Step 4: Write All Files
60 
61> Write files directly from the MCP tool output — CLI scaffolding tools produce incomplete projects missing IaC, RBAC, and managed identity configuration. NEVER hand-write Bicep/Terraform and use `azd init -t <template>`/`func init`/`func new` as fallback when composing multiple recipes and required templates are not found in MCP.
62 
63Each array entry contains `{ path, content }`. For every entry in BOTH arrays:
64 
651. **Create directories** — extract the parent directory from each `path` (e.g., `infra/` from `infra/main.bicep`, `.azure/` from `.azure/config.json`). Create all unique parent directories first.
662. **Write the file** — use the `path` as the file path and `content` as the file body. Write every file exactly as specified.
67 
68| Array | Contains | Action |
69|-------|----------|--------|
70| `functionFiles[]` | Function source code, infra, and config files | Write all — these are the trigger/binding code and IaC |
71| `projectFiles[]` | host.json, dependencies, settings files | Write all — these are runtime configuration |
72 
73**PRESERVE generated IaC security patterns** — keep RBAC, managed identity, and security config intact. When composing multiple templates, merge additively (see [composition.md](recipes/composition.md)).
74 
75> **Skip content verification** — MCP template files are pre-validated. After writing, do not `view`/`cat` files unless you customized them. Check success via exit code and file count only.
76 
77### Step 5: Deploy
78 
79```bash
80azd env set AZURE_LOCATION <region>
81azd up --no-prompt
82```
83 
84---
85 
86## Recipe Composition (Multiple Templates)
87 
88When user needs trigger + bindings not in a single template:
89 
901. **Discover** all templates for language
912. **Select trigger template** as base (has complete project structure)
923. **Select binding templates** for additional integrations
934. **Fetch all** templates (parallel calls)
945. **Compose**:
95   - Use trigger template as base
96   - Extract binding patterns from binding templates
97   - Merge IaC resources and RBAC roles
98   - Add user's custom logic
996. **Trim** unused demo code from samples
100 
101> **AzureWebJobsStorage exception**: Always keep storage account + RBAC — runtime requires it.
102 
103---
104 
105## Fallback (MCP Unavailable)
106 
107If MCP tools are unavailable, download the CDN manifest which points to the same GitHub repos:
108 
109### Step 1: Fetch Manifest
110 
111```
112GET https://cdn.functions.azure.com/public/templates-manifest/manifest.json
113```
114 
115> ⚠️ **If manifest fetch fails** (any error):
116> 1. Fall back to the source manifest at `https://github.com/Azure/azure-functions-templates/blob/dev/Functions.Templates/Template-Manifest/manifest.json`
117> 2. If both sources are unreachable, fall back to known-good repos: `Azure-Samples/functions-quickstart-*` keyed by language + resource (e.g., `functions-quickstart-python-http-azd`)
118> 3. If all fallbacks fail, report the error to the user and ask them to retry later
119 
120### Step 2: Filter Templates
121 
122Each template entry contains:
123 
124| Field | Description | Example |
125|-------|-------------|---------|
126| `language` | Programming language | `Python`, `TypeScript`, `JavaScript`, `Java`, `CSharp`, `PowerShell` |
127| `resource` | Trigger type (see [selection.md](selection.md)) | `http`, `cosmos`, `timer`, `eventhub`, `servicebus`, `blob`, `sql`, `mcp`, `durable` |
128| `iac` | Infrastructure type | `bicep`, `terraform` |
129| `repositoryUrl` | GitHub repo with complete project | `https://github.com/Azure-Samples/functions-quickstart-python-http-azd` |
130| `folderPath` | Path within repo | `.` or `src/api` |
131 
132Filter: `language == <user-lang> AND resource == <mapped-resource> AND iac == <user-iac>`
133 
134### Step 3: Download Template
135 
136**If `folderPath` is `.` (root):** ZIP download + unzip
137 
138```
139GET https://github.com/{owner}/{repo}/archive/refs/heads/main.zip
140unzip main.zip -d <project-dir>
141```
142 
143**If `folderPath` is a subfolder:** Fetch tree + raw file downloads
144 
145```
1461. GET https://api.github.com/repos/{owner}/{repo}/git/trees/main?recursive=1
1472. Filter tree entries where path starts with {folderPath}/
1483. For each file:
149   GET https://raw.githubusercontent.com/{owner}/{repo}/main/{path}
150```
151 
152**If downloads fail:** Fall back to git clone
153 
154```bash
155git clone <repositoryUrl> --depth 1
156# If folderPath != ".", copy only that folder
157```
158 
159The downloaded content is the **same** as MCP `functionFiles[]` + `projectFiles[]`:
160 
161- Source code (function triggers, bindings)
162- IaC (Bicep/Terraform with RBAC, managed identity)
163- azure.yaml (azd configuration)
164- host.json, dependencies
165 
166### Step 4: Deploy
167 
168```bash
169azd up --no-prompt
170```
171 
172---
173 
174## References
175 
176- [Composition Details](recipes/composition.md) — recipe algorithm
177- [Selection Guide](selection.md) — intent→resource mapping
178- [Recipes Index](recipes/README.md) — all available recipes
179- [Base Template Eval](base/eval/summary.md) — HTTP base evaluation results
180 
181**Browse all:** [Awesome AZD Functions](https://azure.github.io/awesome-azd/?tags=functions)
182