How az-scout/az-scout works
Azure Scout helps Azure operators inspect VM availability, zone mappings, pricing, Spot scores, and quota, then assess deployment confidence through a web UI, MCP tools, or terminal chat. The web/API and agent interfaces call shared Azure data services; SKU enrichment can incorporate quota, pricing, Spot, and confidence signals. Planner and topology plugins expose additional planning and mapping capabilities. Plugin discovery and management extend the application. Several subsystem paths are included from the source index and tree without claiming their unsampled internals were inspected; uncertain links are omitted.
Main entry points: __init__.py Azure API facade · app.py Web application · _operations.py Plugin management · routes.py Deployment planner
Components 28
User interfaces
- Web application
src/az_scout/app.py - Discovery routes
src/az_scout/routes/discovery.py - MCP server
src/az_scout/mcp_server.py - Terminal chat
src/az_scout/services/cli_chat.py
Azure data and scoring
- Azure API facade
src/az_scout/azure_api/__init__.py - Tenant discovery
src/az_scout/azure_api/discovery.py - ARM requests
src/az_scout/azure_api/_arm.py - SKU availability
src/az_scout/azure_api/skus.py - VM pricing
src/az_scout/azure_api/pricing.py - Quota data
src/az_scout/azure_api/quotas.py - Spot scores
src/az_scout/azure_api/spot.py - Deployment scoring
src/az_scout/scoring/deployment_confidence.py - API response models
src/az_scout/models/responses.py
AI and planning
- AI chat service
src/az_scout/services/ai_chat/_stream.py - Chat tools
src/az_scout/services/ai_chat/_tools.py - Deployment planner
src/az_scout/internal_plugins/planner/routes.py - Planner tools
src/az_scout/internal_plugins/planner/tools.py - Zone mapping plugin
src/az_scout/internal_plugins/topology/routes.py
Authentication and plugins
- Authentication
src/az_scout/auth.py - OAuth routes
src/az_scout/routes/auth.py - Plugin runtime
src/az_scout/plugins.py - Plugin API
src/az_scout/plugin_api.py - Plugin management
src/az_scout/plugin_manager/_operations.py - Plugin installer
src/az_scout/plugin_manager/_installer.py - Plugin storage
src/az_scout/plugin_manager/_storage.py
Other components
- Azure operator
- Microsoft Azure
- Plugin catalog
Connections 35
- Azure operator → Web application: uses web UI
README.md - Azure operator → MCP server: queries tools
README.md - Azure operator → Terminal chat: asks questions
README.md - Web application → Discovery routes: registers routes
src/az_scout/app.py - Discovery routes → Azure API facade: queries Azure data
src/az_scout/routes/discovery.py - MCP server → Azure API facade: calls data helpers
src/az_scout/mcp_server.py - Terminal chat → Azure API facade: discovers tenants
src/az_scout/services/cli_chat.py - Terminal chat → AI chat service: streams chat
src/az_scout/services/cli_chat.py - Azure API facade → Tenant discovery: exports discovery
src/az_scout/azure_api/__init__.py - Azure API facade → VM pricing: exports pricing
src/az_scout/azure_api/__init__.py - Azure API facade → SKU availability: exports SKU data
src/az_scout/azure_api/__init__.py - Azure API facade → Quota data: exports quota data
src/az_scout/azure_api/__init__.py - Azure API facade → Spot scores: exports Spot scores
src/az_scout/azure_api/__init__.py - Azure API facade → Deployment scoring: enriches confidence
src/az_scout/azure_api/__init__.py - Tenant discovery → ARM requests: uses ARM helpers
src/az_scout/azure_api/discovery.py - Azure API facade → Microsoft Azure: queries Azure
README.md - Discovery routes → API response models: returns models
src/az_scout/routes/discovery.py - Deployment planner → Azure API facade: gets Azure data
src/az_scout/internal_plugins/planner/routes.py - Deployment planner → Deployment scoring: computes confidence
src/az_scout/internal_plugins/planner/routes.py - Deployment planner → API response models: uses response models
src/az_scout/internal_plugins/planner/routes.py - Planner tools → Azure API facade: uses Azure helpers
src/az_scout/internal_plugins/planner/tools.py - Planner tools → Deployment scoring: scores deployments
src/az_scout/internal_plugins/planner/tools.py - Zone mapping plugin → Azure API facade: queries mappings
src/az_scout/internal_plugins/topology/routes.py - Zone mapping plugin → API response models: uses response models
src/az_scout/internal_plugins/topology/routes.py - AI chat service → Chat tools: dispatches tools
src/az_scout/services/ai_chat/_stream.py - Chat tools → MCP server: reuses tool definitions
src/az_scout/services/ai_chat/_tools.py - Web application → Authentication: protects requests
src/az_scout/app.py - Authentication → OAuth routes: reads session token
src/az_scout/auth.py - Web application → Plugin runtime: loads plugins
src/az_scout/app.py - Plugin runtime → Plugin API: registers contributions
src/az_scout/plugins.py - Azure operator → Plugin management: manages plugins
README.md - Plugin management → Plugin installer: runs install actions
src/az_scout/plugin_manager/_operations.py - Plugin management → Plugin storage: reads plugin records
src/az_scout/plugin_manager/_operations.py - Plugin installer → Plugin storage: uses package paths
src/az_scout/plugin_manager/_installer.py - Plugin management → Plugin catalog: browses catalog