@ingenx-io/valets-schema-mcp-server 0.2.0 → 0.2.1

package/data/docs/models/whatsapp-inbound-message.md

@@ -366,4 +366,4 @@ Do not include in write requests. This field is set exclusively by the server (F
 Specific value: `true`
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 01:15:18 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 13:06:59 +0000

package/data/docs/models/whatsapp-outbound-lifecycle-event.md

@@ -303,7 +303,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** (Read-only) Raw Meta error object(s).
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 01:15:18 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 13:06:59 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/whatsapp-outbound-message.md

@@ -582,7 +582,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Required** | No     |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 01:15:18 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 13:06:59 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/whatsapp-template.md

@@ -12,12 +12,17 @@ sidebar_position: 31
 ```json
 {
   "id": null,
+  "waba": "waba",
+  "wabaId": "wab_ref123",
   "name": "Amadou Diallo",
   "language": "language",
   "category": "category",
   "status": "status",
-  "variables": [
-    "example"
+  "parameters": [
+    {
+      "name": "Amadou Diallo",
+      "component": "component"
+    }
   ],
   "preview": "preview"
 }
@@ -27,13 +32,19 @@ sidebar_position: 31
 
 
 - [1. Property `id`](#id)
-- [2. Property `name`](#name)
-- [3. Property `language`](#language)
-- [4. Property `category`](#category)
-- [5. Property `status`](#status)
-- [6. Property `variables`](#variables)
-  - [6.1. variables items](#variables_items)
-- [7. Property `preview`](#preview)
+- [2. Property `waba`](#waba)
+- [3. Property `wabaId`](#wabaId)
+- [4. Property `name`](#name)
+- [5. Property `language`](#language)
+- [6. Property `category`](#category)
+- [7. Property `status`](#status)
+- [8. Property `parameters`](#parameters)
+  - [8.1. parameters items](#parameters_items)
+    - [8.1.1. Property `name`](#parameters_items_name)
+    - [8.1.2. Property `component`](#parameters_items_component)
+    - [8.1.3. Property `buttonIndex`](#parameters_items_buttonIndex)
+    - [8.1.4. Property `buttonSubType`](#parameters_items_buttonSubType)
+- [9. Property `preview`](#preview)
 
 |                           |                                 |
 | ------------------------- | ------------------------------- |
@@ -42,17 +53,19 @@ sidebar_position: 31
 | **Additional properties** | Not allowed                     |
 | **Defined in**            | #/definitions/whatsapp-template |
 
-**Description:** WhatsappTemplate — Meta-approved template synced from the WhatsApp Business API (GH#43). Collection: whatsapp_templates/\{docId\}. Backend-synced; dashboard reads only.
+**Description:** WhatsappTemplate — Meta-approved template synced from the WhatsApp Business API (GH#43; parameter placement GH#46). Collection: whatsapp_templates/\{docId\}, doc ID `\{waba\}__\{name\}__\{language\}`. WABA-scoped; backend-synced; dashboard reads only.
 
-| Property                   | Pattern | Type             | Deprecated | Definition                                | Title/Description                                                                                                                                |
-| -------------------------- | ------- | ---------------- | ---------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
-| - [id](#id )               | No      | string or null   | No         | -                                         | (Read-only) Firestore document ID — composite \`\{name\}__\{language\}\`.                                                                            |
-| + [name](#name )           | No      | string           | No         | -                                         | (Read-only) Template name as registered with Meta.                                                                                               |
-| + [language](#language )   | No      | string           | No         | -                                         | (Read-only) Template language/locale code (e.g. "en", "fr").                                                                                     |
-| + [category](#category )   | No      | string           | No         | -                                         | (Read-only) Meta template category (e.g. MARKETING, UTILITY, AUTHENTICATION).                                                                    |
-| + [status](#status )       | No      | enum (of string) | No         | In #/definitions/whatsapp-template-status | (Read-only) Meta review status. Only APPROVED templates can be sent.                                                                             |
-| + [variables](#variables ) | No      | array of string  | No         | -                                         | (Read-only) Declared variable names/placeholders. A message supplies values keyed by these names via WhatsappOutboundMessage.template.variables. |
-| + [preview](#preview )     | No      | string           | No         | -                                         | (Read-only) Rendered preview text for display in the dashboard picker.                                                                           |
+| Property                     | Pattern | Type             | Deprecated | Definition                                | Title/Description                                                                                                                                                                                                                                                                 |
+| ---------------------------- | ------- | ---------------- | ---------- | ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| - [id](#id )                 | No      | string or null   | No         | -                                         | (Read-only) Firestore document ID — composite \`\{waba\}__\{name\}__\{language\}\`.                                                                                                                                                                                                     |
+| + [waba](#waba )             | No      | enum (of string) | No         | In #/definitions/waba-label               | (Read-only) WABA label this template is approved on. Templates are WABA-scoped. Mirrors WhatsappOutboundMessage.waba.                                                                                                                                                             |
+| + [wabaId](#wabaId )         | No      | string           | No         | -                                         | (Read-only) Meta WABA ID this template belongs to. The sender must verify its phone number belongs to this WABA before using the template.                                                                                                                                        |
+| + [name](#name )             | No      | string           | No         | -                                         | (Read-only) Template name as registered with Meta.                                                                                                                                                                                                                                |
+| + [language](#language )     | No      | string           | No         | -                                         | (Read-only) Template language/locale code (e.g. "en", "fr").                                                                                                                                                                                                                      |
+| + [category](#category )     | No      | string           | No         | -                                         | (Read-only) Meta template category (e.g. MARKETING, UTILITY, AUTHENTICATION).                                                                                                                                                                                                     |
+| + [status](#status )         | No      | enum (of string) | No         | In #/definitions/whatsapp-template-status | (Read-only) Meta review status. Only APPROVED templates can be sent.                                                                                                                                                                                                              |
+| + [parameters](#parameters ) | No      | array of object  | No         | -                                         | (Read-only) Declared parameters with component placement. Supersedes the flat \`variables\` list (GH#46) — lets the send group values into the correct header/body/button components. A message supplies values keyed by \`name\` via WhatsappOutboundMessage.template.variables. |
+| + [preview](#preview )       | No      | string           | No         | -                                         | (Read-only) Rendered preview text for display in the dashboard picker.                                                                                                                                                                                                            |
 
 ## <a name="id"></a>1. Property `id`
 
@@ -61,13 +74,44 @@ sidebar_position: 31
 | **Type**     | `string or null` |
 | **Required** | No               |
 
-**Description:** (Read-only) Firestore document ID — composite `\{name\}__\{language\}`.
+**Description:** (Read-only) Firestore document ID — composite `\{waba\}__\{name\}__\{language\}`.
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
 :::
 
-## <a name="name"></a>2. Property `name`
+## <a name="waba"></a>2. Property `waba`
+
+|                |                          |
+| -------------- | ------------------------ |
+| **Type**       | `enum (of string)`       |
+| **Required**   | Yes                      |
+| **Defined in** | #/definitions/waba-label |
+
+**Description:** (Read-only) WABA label this template is approved on. Templates are WABA-scoped. Mirrors WhatsappOutboundMessage.waba.
+
+Must be one of:
+* "cmz"
+* "val"
+
+:::warning Server-set
+Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
+:::
+
+## <a name="wabaId"></a>3. Property `wabaId`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** (Read-only) Meta WABA ID this template belongs to. The sender must verify its phone number belongs to this WABA before using the template.
+
+:::warning Server-set
+Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
+:::
+
+## <a name="name"></a>4. Property `name`
 
 |              |          |
 | ------------ | -------- |
@@ -80,7 +124,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
 :::
 
-## <a name="language"></a>3. Property `language`
+## <a name="language"></a>5. Property `language`
 
 |              |          |
 | ------------ | -------- |
@@ -93,7 +137,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
 :::
 
-## <a name="category"></a>4. Property `category`
+## <a name="category"></a>6. Property `category`
 
 |              |          |
 | ------------ | -------- |
@@ -106,7 +150,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
 :::
 
-## <a name="status"></a>5. Property `status`
+## <a name="status"></a>7. Property `status`
 
 |                |                                        |
 | -------------- | -------------------------------------- |
@@ -128,14 +172,14 @@ Must be one of:
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
 :::
 
-## <a name="variables"></a>6. Property `variables`
+## <a name="parameters"></a>8. Property `parameters`
 
 |              |                   |
 | ------------ | ----------------- |
-| **Type**     | `array of string` |
+| **Type**     | `array of object` |
 | **Required** | Yes               |
 
-**Description:** (Read-only) Declared variable names/placeholders. A message supplies values keyed by these names via WhatsappOutboundMessage.template.variables.
+**Description:** (Read-only) Declared parameters with component placement. Supersedes the flat `variables` list (GH#46) — lets the send group values into the correct header/body/button components. A message supplies values keyed by `name` via WhatsappOutboundMessage.template.variables.
 
 |                      | Array restrictions |
 | -------------------- | ------------------ |
@@ -145,22 +189,84 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Additional items** | False              |
 | **Tuple validation** | See below          |
 
-| Each item of this array must be     | Description |
-| ----------------------------------- | ----------- |
-| [variables items](#variables_items) | -           |
+| Each item of this array must be       | Description                                                            |
+| ------------------------------------- | ---------------------------------------------------------------------- |
+| [parameters items](#parameters_items) | Declared WhatsApp template parameter with component placement (GH#46). |
+
+### <a name="parameters_items"></a>8.1. parameters items
+
+|                           |             |
+| ------------------------- | ----------- |
+| **Type**                  | `object`    |
+| **Required**              | No          |
+| **Additional properties** | Not allowed |
 
-### <a name="variables_items"></a>6.1. variables items
+**Description:** Declared WhatsApp template parameter with component placement (GH#46).
+
+| Property                                            | Pattern | Type             | Deprecated | Definition                                   | Title/Description                                                                                        |
+| --------------------------------------------------- | ------- | ---------------- | ---------- | -------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
+| + [name](#parameters_items_name )                   | No      | string           | No         | -                                            | Parameter name/placeholder (e.g. "1"). Matches a key in WhatsappOutboundMessage.template.variables.      |
+| + [component](#parameters_items_component )         | No      | enum (of string) | No         | In #/definitions/whatsapp-template-component | Which template component this parameter targets: header \| body \| button.                               |
+| - [buttonIndex](#parameters_items_buttonIndex )     | No      | integer          | No         | -                                            | 0-based button position. Present only when component=button (Meta requires a string index at send time). |
+| - [buttonSubType](#parameters_items_buttonSubType ) | No      | enum (of string) | No         | In #/definitions/whatsapp-button-sub-type    | Button sub-type (url \| quick_reply). Present only when component=button.                                |
+
+#### <a name="parameters_items_name"></a>8.1.1. Property `name`
 
 |              |          |
 | ------------ | -------- |
 | **Type**     | `string` |
-| **Required** | No       |
+| **Required** | Yes      |
+
+**Description:** Parameter name/placeholder (e.g. "1"). Matches a key in WhatsappOutboundMessage.template.variables.
+
+#### <a name="parameters_items_component"></a>8.1.2. Property `component`
+
+|                |                                           |
+| -------------- | ----------------------------------------- |
+| **Type**       | `enum (of string)`                        |
+| **Required**   | Yes                                       |
+| **Defined in** | #/definitions/whatsapp-template-component |
+
+**Description:** Which template component this parameter targets: header | body | button.
+
+Must be one of:
+* "header"
+* "body"
+* "button"
+
+#### <a name="parameters_items_buttonIndex"></a>8.1.3. Property `buttonIndex`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | No        |
+
+**Description:** 0-based button position. Present only when component=button (Meta requires a string index at send time).
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+#### <a name="parameters_items_buttonSubType"></a>8.1.4. Property `buttonSubType`
+
+|                |                                        |
+| -------------- | -------------------------------------- |
+| **Type**       | `enum (of string)`                     |
+| **Required**   | No                                     |
+| **Defined in** | #/definitions/whatsapp-button-sub-type |
+
+**Description:** Button sub-type (url | quick_reply). Present only when component=button.
+
+Must be one of:
+* "url"
+* "quick_reply"
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
 :::
 
-## <a name="preview"></a>7. Property `preview`
+## <a name="preview"></a>9. Property `preview`
 
 |              |          |
 | ------------ | -------- |
@@ -170,7 +276,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** (Read-only) Rendered preview text for display in the dashboard picker.
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 01:15:18 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 13:06:59 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/static/llms.txt

@@ -110,6 +110,14 @@ Values: VALID, USED, CANCELLED
 Human-readable WABA label identifying which Meta business number received the message (GH#36).
 Values: cmz, val
 
+### WhatsappButtonSubType
+Sub-type of a WhatsApp template button parameter. Set when WhatsappTemplateParameter.component === "button" — maps to Meta `components[].sub_type` (GH#46).
+Values: url, quick_reply
+
+### WhatsappTemplateComponent
+WhatsApp template component a parameter targets. Determines which Meta `components` entry the supplied value is placed in at send time (GH#46).
+Values: header, body, button
+
 ### WhatsappTemplateStatus
 Meta review status of a WhatsApp message template, synced from the WhatsApp Business API. Only APPROVED templates can be sent. The fuller Meta status set is used deliberately (vs just APPROVED/PENDING/REJECTED) so this enum has a distinct value signature from PaymentProofStatus in the JSON-Schema $ref matcher (GH#43).
 Values: APPROVED, PENDING, REJECTED, PAUSED, DISABLED, IN_APPEAL
@@ -1613,28 +1621,39 @@ Example:
 ```
 
 ### WhatsappTemplate
-Fields: 7 (6 required)
+Fields: 9 (8 required)
 
 | Field | Type | Required | Description |
 |-------|------|----------|-------------|
-| id | ['string', 'null'] | no | (Read-only) Firestore document ID — composite `{name}__{language}`. |
+| id | ['string', 'null'] | no | (Read-only) Firestore document ID — composite `{waba}__{name}__{language}`. |
+| waba | WabaLabel | yes | (Read-only) WABA label this template is approved on. Templates are WABA-scoped. Mirrors WhatsappOutboundMessage.waba. |
+| wabaId | string | yes | (Read-only) Meta WABA ID this template belongs to. The sender must verify its phone number belongs to this WABA before using the template. |
 | name | string | yes | (Read-only) Template name as registered with Meta. |
 | language | string | yes | (Read-only) Template language/locale code (e.g. "en", "fr"). |
 | category | string | yes | (Read-only) Meta template category (e.g. MARKETING, UTILITY, AUTHENTICATION). |
 | status | WhatsappTemplateStatus | yes | (Read-only) Meta review status. Only APPROVED templates can be sent. |
-| variables | array<string> | yes | (Read-only) Declared variable names/placeholders. A message supplies values keyed by these names via WhatsappOutboundMessage.template.variables. |
+| parameters | array<object> | yes | (Read-only) Declared parameters with component placement. Supersedes the flat `variables` list (GH#46) — lets the send group values into the correct header/body/button components. A message supplies values keyed by `name` via WhatsappOutboundMessage.template.variables. |
+| parameters[].name | string | yes | Parameter name/placeholder (e.g. "1"). Matches a key in WhatsappOutboundMessage.template.variables. |
+| parameters[].component | WhatsappTemplateComponent | yes | Which template component this parameter targets: header | body | button. |
+| parameters[].buttonIndex | integer | no | 0-based button position. Present only when component=button (Meta requires a string index at send time). |
+| parameters[].buttonSubType | WhatsappButtonSubType | no | Button sub-type (url | quick_reply). Present only when component=button. |
 | preview | string | yes | (Read-only) Rendered preview text for display in the dashboard picker. |
 
 Example:
 ```json
 {
   "id": null,
+  "waba": "waba",
+  "wabaId": "wab_ref123",
   "name": "Amadou Diallo",
   "language": "language",
   "category": "category",
   "status": "status",
-  "variables": [
-    "example"
+  "parameters": [
+    {
+      "name": "Amadou Diallo",
+      "component": "component"
+    }
   ],
   "preview": "preview"
 }

package/data/static/openapi.yaml

@@ -274,6 +274,21 @@ components:
       - val
       description: Human-readable WABA label identifying which Meta business number
         received the message (GH#36).
+    WhatsappButtonSubType:
+      type: string
+      enum:
+      - url
+      - quick_reply
+      description: Sub-type of a WhatsApp template button parameter. Set when WhatsappTemplateParameter.component
+        === "button" — maps to Meta `components[].sub_type` (GH#46).
+    WhatsappTemplateComponent:
+      type: string
+      enum:
+      - header
+      - body
+      - button
+      description: WhatsApp template component a parameter targets. Determines which
+        Meta `components` entry the supplied value is placed in at send time (GH#46).
     WhatsappTemplateStatus:
       type: string
       enum:
@@ -4804,10 +4819,20 @@ components:
       properties:
         id:
           readOnly: true
-          description: (Read-only) Firestore document ID — composite `{name}__{language}`.
+          description: (Read-only) Firestore document ID — composite `{waba}__{name}__{language}`.
           type:
           - string
           - 'null'
+        waba:
+          $ref: '#/components/schemas/WabaLabel'
+          description: (Read-only) WABA label this template is approved on. Templates
+            are WABA-scoped. Mirrors WhatsappOutboundMessage.waba.
+          readOnly: true
+        wabaId:
+          type: string
+          readOnly: true
+          description: (Read-only) Meta WABA ID this template belongs to. The sender
+            must verify its phone number belongs to this WABA before using the template.
         name:
           type: string
           readOnly: true
@@ -4826,29 +4851,59 @@ components:
           description: (Read-only) Meta review status. Only APPROVED templates can
             be sent.
           readOnly: true
-        variables:
+        parameters:
           type: array
           items:
-            type: string
+            type: object
+            properties:
+              name:
+                type: string
+                description: Parameter name/placeholder (e.g. "1"). Matches a key
+                  in WhatsappOutboundMessage.template.variables.
+              component:
+                $ref: '#/components/schemas/WhatsappTemplateComponent'
+                description: 'Which template component this parameter targets: header
+                  | body | button.'
+              buttonIndex:
+                description: 0-based button position. Present only when component=button
+                  (Meta requires a string index at send time).
+                type: integer
+                minimum: -9007199254740991
+                maximum: 9007199254740991
+              buttonSubType:
+                $ref: '#/components/schemas/WhatsappButtonSubType'
+                description: Button sub-type (url | quick_reply). Present only when
+                  component=button.
+            required:
+            - name
+            - component
+            additionalProperties: false
+            description: Declared WhatsApp template parameter with component placement
+              (GH#46).
           readOnly: true
-          description: (Read-only) Declared variable names/placeholders. A message
-            supplies values keyed by these names via WhatsappOutboundMessage.template.variables.
+          description: (Read-only) Declared parameters with component placement. Supersedes
+            the flat `variables` list (GH#46) — lets the send group values into the
+            correct header/body/button components. A message supplies values keyed
+            by `name` via WhatsappOutboundMessage.template.variables.
         preview:
           type: string
           readOnly: true
           description: (Read-only) Rendered preview text for display in the dashboard
             picker.
       required:
+      - waba
+      - wabaId
       - name
       - language
       - category
       - status
-      - variables
+      - parameters
       - preview
       additionalProperties: false
       description: 'WhatsappTemplate — Meta-approved template synced from the WhatsApp
-        Business API (GH#43). Collection: whatsapp_templates/{docId}. Backend-synced;
-        dashboard reads only.'
+        Business API (GH#43; parameter placement GH#46). Collection: whatsapp_templates/{docId},
+        doc ID `{waba}__{name}__{language}`. WABA-scoped; backend-synced; dashboard
+        reads only.'
     PaymentSummary:
       type: object
       properties:

package/data/static/schemas.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "description": "@valets/schema \u2014 consolidated schema bundle",
-  "generated": "2026-05-27T01:15:18.169259+00:00",
+  "generated": "2026-05-27T13:06:59.435619+00:00",
   "schemas": {
     "allowed-user": {
       "type": "object",
@@ -5565,6 +5565,14 @@
       ],
       "description": "Human-readable WABA label identifying which Meta business number received the message (GH#36)."
     },
+    "whatsapp-button-sub-type": {
+      "type": "string",
+      "enum": [
+        "url",
+        "quick_reply"
+      ],
+      "description": "Sub-type of a WhatsApp template button parameter. Set when WhatsappTemplateParameter.component === \"button\" \u2014 maps to Meta `components[].sub_type` (GH#46)."
+    },
     "whatsapp-inbound-message": {
       "type": "object",
       "properties": {
@@ -6052,12 +6060,22 @@
       "properties": {
         "id": {
           "readOnly": true,
-          "description": "(Read-only) Firestore document ID \u2014 composite `{name}__{language}`.",
+          "description": "(Read-only) Firestore document ID \u2014 composite `{waba}__{name}__{language}`.",
           "type": [
             "string",
             "null"
           ]
         },
+        "waba": {
+          "$ref": "#/definitions/waba-label",
+          "description": "(Read-only) WABA label this template is approved on. Templates are WABA-scoped. Mirrors WhatsappOutboundMessage.waba.",
+          "readOnly": true
+        },
+        "wabaId": {
+          "type": "string",
+          "readOnly": true,
+          "description": "(Read-only) Meta WABA ID this template belongs to. The sender must verify its phone number belongs to this WABA before using the template."
+        },
         "name": {
           "type": "string",
           "readOnly": true,
@@ -6078,13 +6096,39 @@
           "description": "(Read-only) Meta review status. Only APPROVED templates can be sent.",
           "readOnly": true
         },
-        "variables": {
+        "parameters": {
           "type": "array",
           "items": {
-            "type": "string"
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "Parameter name/placeholder (e.g. \"1\"). Matches a key in WhatsappOutboundMessage.template.variables."
+              },
+              "component": {
+                "$ref": "#/definitions/whatsapp-template-component",
+                "description": "Which template component this parameter targets: header | body | button."
+              },
+              "buttonIndex": {
+                "description": "0-based button position. Present only when component=button (Meta requires a string index at send time).",
+                "type": "integer",
+                "minimum": -9007199254740991,
+                "maximum": 9007199254740991
+              },
+              "buttonSubType": {
+                "$ref": "#/definitions/whatsapp-button-sub-type",
+                "description": "Button sub-type (url | quick_reply). Present only when component=button."
+              }
+            },
+            "required": [
+              "name",
+              "component"
+            ],
+            "additionalProperties": false,
+            "description": "Declared WhatsApp template parameter with component placement (GH#46)."
           },
           "readOnly": true,
-          "description": "(Read-only) Declared variable names/placeholders. A message supplies values keyed by these names via WhatsappOutboundMessage.template.variables."
+          "description": "(Read-only) Declared parameters with component placement. Supersedes the flat `variables` list (GH#46) \u2014 lets the send group values into the correct header/body/button components. A message supplies values keyed by `name` via WhatsappOutboundMessage.template.variables."
         },
         "preview": {
           "type": "string",
@@ -6093,27 +6137,43 @@
         }
       },
       "required": [
+        "waba",
+        "wabaId",
         "name",
         "language",
         "category",
         "status",
-        "variables",
+        "parameters",
         "preview"
       ],
       "additionalProperties": false,
-      "description": "WhatsappTemplate \u2014 Meta-approved template synced from the WhatsApp Business API (GH#43). Collection: whatsapp_templates/{docId}. Backend-synced; dashboard reads only.",
+      "description": "WhatsappTemplate \u2014 Meta-approved template synced from the WhatsApp Business API (GH#43; parameter placement GH#46). Collection: whatsapp_templates/{docId}, doc ID `{waba}__{name}__{language}`. WABA-scoped; backend-synced; dashboard reads only.",
       "example": {
         "id": null,
+        "waba": "waba",
+        "wabaId": "wab_ref123",
         "name": "Amadou Diallo",
         "language": "language",
         "category": "category",
         "status": "status",
-        "variables": [
-          "example"
+        "parameters": [
+          {
+            "name": "Amadou Diallo",
+            "component": "component"
+          }
         ],
         "preview": "preview"
       }
     },
+    "whatsapp-template-component": {
+      "type": "string",
+      "enum": [
+        "header",
+        "body",
+        "button"
+      ],
+      "description": "WhatsApp template component a parameter targets. Determines which Meta `components` entry the supplied value is placed in at send time (GH#46)."
+    },
     "whatsapp-template-status": {
       "type": "string",
       "enum": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ingenx-io/valets-schema-mcp-server",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "MCP server exposing @valets/schema documentation to AI agents",
   "type": "module",
   "main": "index.js",