az-scout-plugin-avs-sku 2026.3.4

Azure VMware Solution (AVS) SKU exploration plugin for az-scout

az-scout-plugin-avs-sku

az-scout plugin for Azure VMware Solution (AVS) SKU exploration.

Plugin role

This plugin helps compare AVS SKUs by combining:

• technical specs (CPU, RAM, cores, architecture, vSAN) from upstream SKU metadata,
• regional retail pricing (PAYG and reservation monthly equivalents),
• generation labels (Generation 1 / Generation 2 when applicable by region).

Features

• AVS SKU tab (AVS SKU) with BYOL toggle and pricing display mode selector.
• Pricing scope selector: public prices list, or selected subscription scope.
• AVS generation awareness.
• Chat integration:
  • MCP tool: avs_sku_tool
  • custom chat mode: avs-sku-advisor
  • default-mode addendum for AV* SKU interpretation.

REST API

Base path (mounted by az-scout):

/plugins/avs-sku

Endpoint

GET /plugins/avs-sku/skus

Query parameters

• region (optional, string): Azure region key (for example eastus).
• byol (optional, bool, default true): include BYOL pricing rows.
• sku (optional, string): filter SKUs by name fragment.
• pricing_source (optional, string, default public): public or subscription.
• subscription_id (optional, string): selected subscription when pricing_source=subscription.

Behavior notes

• If region is omitted, response still includes technical SKU data, but no regional pricing lookup.
• Current pricing retrieval uses Azure Retail Prices API. pricing_source and subscription_id are preserved in response metadata for scope continuity.

Response shape (summary)

{
    "region": "eastus",
    "byol": true,
    "sku_filter": "AV64",
    "pricing_source": "public",
    "subscription_id": "",
    "source": {
        "technical": "https://.../sku.json",
        "pricing": "https://prices.azure.com/api/retail/prices"
    },
    "items": [
        {
            "name": "AV64",
            "technical": { "...": "..." },
            "generation_labels": ["Generation 1", "Generation 2"],
            "stretched_cluster": false,
            "available_in_region": true,
            "price": {
                "found": true,
                "byol": true,
                "currency_code": "USD",
                "payg_hour": 12.34,
                "payg_month": 9008.2,
                "reservation_1y_month": 7000.0,
                "reservation_3y_month": 5400.0,
                "reservation_5y_month": 4900.0
            }
        }
    ]
}

MCP tool

Tool name: avs_sku_tool

Parameters

• region: str | None = None
• byol: bool = True
• sku: str | None = None
• pricing_source: str = "public"
• subscription_id: str | None = None

Return value

• Returns a JSON string (serialized payload) with the same structure as the REST endpoint.

Setup

uv pip install az-scout-plugin-avs-sku
az-scout  # plugin is auto-discovered

For development:

git clone https://github.com/az-scout/az-scout-plugin-avs-sku
cd az-scout-plugin-avs-sku
uv sync --group dev
uv pip install -e .
az-scout  # plugin is auto-discovered

Structure

src/az_scout_avs_sku/
├── __init__.py
├── avs_data.py
├── routes.py
├── tools.py
└── static/
    ├── css/avs-sku.css
    ├── html/avs-sku-tab.html
    └── js/avs-sku-tab.js

Quality checks

uv run ruff check src/ tests/
uv run ruff format --check src/ tests/
uv run mypy src/
uv run pytest

Copilot support

The .github/copilot-instructions.md file provides context to GitHub Copilot about the plugin structure, conventions, and az-scout plugin API.

License

MIT

Disclaimer

This tool is not affiliated with Microsoft. All capacity, pricing, and availability information is indicative and not a guarantee of deployment success. Values are dynamic and may change between planning and actual deployment. Always validate in official Microsoft sources and in your target tenant/subscription.