az-scout-plugin-bdd-sku

SKU DB Cache plugin for az-scout — adds a UI tab and 24 MCP tools for querying Azure VM pricing, spot eviction rates, and availability data. This plugin is a lightweight HTTP client that proxies all requests to the standalone az-scout-bdd-api.

Architecture

┌──────────────────────────────────────────────────────┐
│                    az-scout (core)                    │
│                                                      │
│  ┌─────────────────────────────────────────────────┐ │
│  │          az-scout-plugin-bdd-sku                │ │
│  │                                                 │ │
│  │  Plugin Routes     MCP Tools      UI Tab        │ │
│  │  /status           24 tools       SKU DB Cache  │ │
│  │  /settings         (LLM chat)     (D3 charts)   │ │
│  └────────┬────────────────────────────────────────┘ │
│           │ HTTP                                     │
└───────────┼──────────────────────────────────────────┘
            │
            ▼
┌───────────────────────┐       ┌──────────────────────────┐
│  az-scout-bdd-api     │       │  az-scout-bdd-ingestion   │
│  (REST API)           │◄──────│  (data pipeline)          │
│  Container App        │  PG   │  Ingestion + SKU Mapper   │
│  25 endpoints         │       │  + Price Aggregator       │
└───────────┬───────────┘       └────────────┬─────────────┘
            │                                │
            ▼                                ▼
       ┌──────────────────────────────────────────┐
       │           PostgreSQL 17                   │
       │           (Azure Flexible Server)         │
       └──────────────────────────────────────────┘

The plugin itself contains no database code — it calls the API over HTTP via api_client.py.

Prerequisites

• az-scout ≥ 2026.1
• Python 3.11+
• A running instance of az-scout-bdd-api with ingested data from az-scout-bdd-ingestion

Installation

# Install the plugin (automatically discovered by az-scout)
pip install az-scout-bdd-sku

# Or install in development mode
pip install -e .

Configuration

The plugin needs to know the URL of the standalone API. Configure it via any of these methods (in priority order):

1. Environment variable

export BDD_SKU_API_URL="https://my-api.azurecontainerapps.io"

2. TOML config file

# ~/.config/az-scout/bdd-sku.toml
[api]
base_url = "https://my-api.azurecontainerapps.io"

Override the config file path with AZ_SCOUT_BDD_SKU_CONFIG=/path/to/config.toml.

3. Settings UI

The plugin adds a Settings button in the tab header. Configure the API URL directly from the az-scout web interface — the value is persisted to the TOML config file.

MCP Tools

The plugin exposes 24 tools on the az-scout MCP server, usable by LLMs in the integrated chat. All tools proxy to the standalone API.

API Reference

The plugin proxies to the standalone az-scout-bdd-api which exposes 29 read-only endpoints (4 legacy + 25 v1). Interactive docs are available at /docs (Swagger UI) and /redoc on your API instance.

OpenAPI spec: openapi/v1.yaml (reference copy)

Legacy endpoints

V1 endpoints — Reference data

V1 endpoints — Retail pricing

V1 endpoints — Spot pricing

V1 endpoints — Pricing analytics

V1 endpoints — SKU catalog & operations

V1 endpoints use keyset pagination (limit default 1000, max 5000 + cursor) unless noted.

Related Repositories