Azure Cost Management Skill
Unified skill for all Azure cost management tasks: querying historical costs, forecasting future spending, and optimizing to reduce waste.
When to Use This Skill
Activate this skill when user wants to:
- Query or analyze Azure costs (how much am I spending, show my bill, cost breakdown)
- Break down costs by service, resource, location, or tag
- Analyze cost trends over time
- Forecast future Azure spending or project end-of-month costs
- Optimize Azure costs, reduce spending, or find savings
- Find orphaned or unused resources
- Rightsize Azure VMs, containers, or services
- Generate cost optimization reports
Quick Reference
| Property |
Value |
| Query API Endpoint |
POST {scope}/providers/Microsoft.CostManagement/query?api-version=2023-11-01 |
| Forecast API Endpoint |
POST {scope}/providers/Microsoft.CostManagement/forecast?api-version=2023-11-01 |
| MCP Tools |
azure__documentation, azure__extension_cli_generate, azure__get_azure_bestpractices |
| CLI |
az rest, az monitor metrics list, az resource list |
| Required Role |
Cost Management Reader + Monitoring Reader + Reader on scope |
MCP Tools
| Tool |
Description |
Parameters |
When to Use |
azure__documentation |
Search Azure documentation |
query (Required): search terms |
Research Cost Management API parameters and options |
azure__extension_cli_generate |
Generate Azure CLI commands |
intent (Required): task description, cli-type (Required): "az" |
Construct az rest commands for cost queries |
azure__get_azure_bestpractices |
Get Azure best practices |
intent (Required): optimization context |
Inform query design with cost management best practices |
azure__extension_azqr |
Run Azure Quick Review compliance scan |
subscription (Required): subscription ID, resource-group (Optional): resource group name |
Find orphaned resources and cost optimization opportunities |
azure__aks |
Azure Kubernetes Service operations |
varies by sub-command |
AKS cost analysis: list clusters, get node pools, inspect configuration |
💡 Tip: Prefer MCP tools over direct CLI commands. Use az rest only when MCP tools don't cover the specific operation.
Routing
Read the user's request and follow the appropriate workflow below.
| User Intent |
Workflow |
Example Prompts |
| Understand current costs |
Cost Query Workflow |
"how much am I spending", "cost by service", "show my bill" |
| Reduce costs / find waste |
Cost Optimization Workflow |
"optimize costs", "find orphaned resources", "reduce spending" |
| Project future costs |
Cost Forecast Workflow |
"forecast costs", "end of month estimate", "how much will I spend" |
| Full cost picture |
All three workflows combined |
"give me the full picture of my Azure costs" |
Important: When optimizing costs, always present the total bill and cost breakdown alongside optimization recommendations.
Scope Reference (Shared Across All Workflows)
| Scope |
URL Pattern |
| Subscription |
/subscriptions/<subscription-id> |
| Resource Group |
/subscriptions/<subscription-id>/resourceGroups/<resource-group-name> |
| Management Group |
/providers/Microsoft.Management/managementGroups/<management-group-id> |
| Billing Account |
/providers/Microsoft.Billing/billingAccounts/<billing-account-id> |
| Billing Profile |
/providers/Microsoft.Billing/billingAccounts/<billing-account-id>/billingProfiles/<billing-profile-id> |
💡 Tip: These are scope paths only — not complete URLs. Combine with the API endpoint and version.
Part 1: Cost Query Workflow
For the full cost query workflow (scope selection, report types, timeframes, dataset configuration, API calls, pagination, guardrails, examples, and error handling), see:
📄 Cost Query Workflow
Part 2: Cost Optimization Workflow
For the full cost optimization workflow (prerequisites, best practices, Redis/AKS-specific analysis, Azure Quick Review, resource discovery, cost queries, pricing validation, utilization metrics, and report generation), see:
📄 Cost Optimization Workflow
Part 3: Cost Forecast Workflow
For the full cost forecast workflow (scope selection, time period rules, dataset configuration, forecast-specific options, API calls, response interpretation, guardrails, and error handling), see:
📄 Cost Forecast Workflow
Data Classification
- ACTUAL DATA = Retrieved from Azure Cost Management API
- ACTUAL METRICS = Retrieved from Azure Monitor
- VALIDATED PRICING = Retrieved from official Azure pricing pages
- ESTIMATED SAVINGS = Calculated based on actual data and validated pricing
Best Practices
- Always query actual costs first — never estimate or assume
- Always present the total bill alongside optimization recommendations
- Validate pricing from official sources — account for free tiers
- Use REST API for cost queries (more reliable than
az costmanagement query)
- Save audit trail — include all queries and responses
- Include Azure Portal links for all resources
- For costs < $10/month, emphasize operational improvements over financial savings
- Never execute destructive operations without explicit approval
Common Pitfalls
- Assuming costs: Always query actual data from Cost Management API
- Ignoring free tiers: Many services have generous allowances
- Using wrong date ranges: 30 days for costs, 14 days for utilization
- Not showing the bill: Always present cost breakdown alongside optimization recommendations
- Cost query failures: Use
az rest with JSON body, not az costmanagement query
Safety Requirements
- Get approval before deleting resources
- Test changes in non-production first
- Provide dry-run commands for validation
- Include rollback procedures
SDK Quick References
1---2name: azure-cost3description: Unified Azure cost management: query historical costs, forecast future spending, and optimize to reduce waste. WHEN: "Azure costs", "Azure spending", "Azure bill", "cost breakdown", "cost by service", "cost by resource", "how much am I spending", "show my bill", "monthly cost summary", "cost tren...4license: MIT5---6# Azure Cost Management Skill78Unified skill for all Azure cost management tasks: querying historical costs, forecasting future spending, and optimizing to reduce waste.910## When to Use This Skill1112Activate this skill when user wants to:13- Query or analyze Azure costs (how much am I spending, show my bill, cost breakdown)14- Break down costs by service, resource, location, or tag15- Analyze cost trends over time16- Forecast future Azure spending or project end-of-month costs17- Optimize Azure costs, reduce spending, or find savings18- Find orphaned or unused resources19- Rightsize Azure VMs, containers, or services20- Generate cost optimization reports2122## Quick Reference2324| Property | Value |25|----------|-------|26| **Query API Endpoint** | `POST {scope}/providers/Microsoft.CostManagement/query?api-version=2023-11-01` |27| **Forecast API Endpoint** | `POST {scope}/providers/Microsoft.CostManagement/forecast?api-version=2023-11-01` |28| **MCP Tools** | `azure__documentation`, `azure__extension_cli_generate`, `azure__get_azure_bestpractices` |29| **CLI** | `az rest`, `az monitor metrics list`, `az resource list` |30| **Required Role** | Cost Management Reader + Monitoring Reader + Reader on scope |3132## MCP Tools3334| Tool | Description | Parameters | When to Use |35|------|-------------|------------|-------------|36| `azure__documentation` | Search Azure documentation | `query` (Required): search terms | Research Cost Management API parameters and options |37| `azure__extension_cli_generate` | Generate Azure CLI commands | `intent` (Required): task description, `cli-type` (Required): `"az"` | Construct `az rest` commands for cost queries |38| `azure__get_azure_bestpractices` | Get Azure best practices | `intent` (Required): optimization context | Inform query design with cost management best practices |39| `azure__extension_azqr` | Run Azure Quick Review compliance scan | `subscription` (Required): subscription ID, `resource-group` (Optional): resource group name | Find orphaned resources and cost optimization opportunities |40| `azure__aks` | Azure Kubernetes Service operations | varies by sub-command | AKS cost analysis: list clusters, get node pools, inspect configuration |4142> 💡 **Tip:** Prefer MCP tools over direct CLI commands. Use `az rest` only when MCP tools don't cover the specific operation.4344---4546## Routing4748Read the user's request and follow the appropriate workflow below.4950| User Intent | Workflow | Example Prompts |51|-------------|----------|-----------------|52| Understand current costs | [Cost Query Workflow](cost-query/workflow.md) | "how much am I spending", "cost by service", "show my bill" |53| Reduce costs / find waste | [Cost Optimization Workflow](cost-optimization/workflow.md) | "optimize costs", "find orphaned resources", "reduce spending" |54| Project future costs | [Cost Forecast Workflow](cost-forecast/workflow.md) | "forecast costs", "end of month estimate", "how much will I spend" |55| Full cost picture | All three workflows combined | "give me the full picture of my Azure costs" |5657> **Important:** When optimizing costs, always present the total bill and cost breakdown alongside optimization recommendations.5859---6061## Scope Reference (Shared Across All Workflows)6263| Scope | URL Pattern |64|-------|-------------|65| Subscription | `/subscriptions/<subscription-id>` |66| Resource Group | `/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>` |67| Management Group | `/providers/Microsoft.Management/managementGroups/<management-group-id>` |68| Billing Account | `/providers/Microsoft.Billing/billingAccounts/<billing-account-id>` |69| Billing Profile | `/providers/Microsoft.Billing/billingAccounts/<billing-account-id>/billingProfiles/<billing-profile-id>` |7071> 💡 **Tip:** These are scope paths only — not complete URLs. Combine with the API endpoint and version.7273---7475## Part 1: Cost Query Workflow7677For the full cost query workflow (scope selection, report types, timeframes, dataset configuration, API calls, pagination, guardrails, examples, and error handling), see:7879📄 **[Cost Query Workflow](cost-query/workflow.md)**8081---8283## Part 2: Cost Optimization Workflow8485For the full cost optimization workflow (prerequisites, best practices, Redis/AKS-specific analysis, Azure Quick Review, resource discovery, cost queries, pricing validation, utilization metrics, and report generation), see:8687📄 **[Cost Optimization Workflow](cost-optimization/workflow.md)**8889---9091## Part 3: Cost Forecast Workflow9293For the full cost forecast workflow (scope selection, time period rules, dataset configuration, forecast-specific options, API calls, response interpretation, guardrails, and error handling), see:9495📄 **[Cost Forecast Workflow](cost-forecast/workflow.md)**9697---9899## Data Classification100101- **ACTUAL DATA** = Retrieved from Azure Cost Management API102- **ACTUAL METRICS** = Retrieved from Azure Monitor103- **VALIDATED PRICING** = Retrieved from official Azure pricing pages104- **ESTIMATED SAVINGS** = Calculated based on actual data and validated pricing105106## Best Practices107108- Always query actual costs first — never estimate or assume109- Always present the total bill alongside optimization recommendations110- Validate pricing from official sources — account for free tiers111- Use REST API for cost queries (more reliable than `az costmanagement query`)112- Save audit trail — include all queries and responses113- Include Azure Portal links for all resources114- For costs < $10/month, emphasize operational improvements over financial savings115- Never execute destructive operations without explicit approval116117## Common Pitfalls118119- **Assuming costs**: Always query actual data from Cost Management API120- **Ignoring free tiers**: Many services have generous allowances121- **Using wrong date ranges**: 30 days for costs, 14 days for utilization122- **Not showing the bill**: Always present cost breakdown alongside optimization recommendations123- **Cost query failures**: Use `az rest` with JSON body, not `az costmanagement query`124125## Safety Requirements126127- Get approval before deleting resources128- Test changes in non-production first129- Provide dry-run commands for validation130- Include rollback procedures131132## SDK Quick References133134- **Redis Management**: [.NET](cost-optimization/sdk/azure-resource-manager-redis-dotnet.md)