CloudScope MCP
Ask your AI about your cloud bill.
Install
What It Does
CloudScope gives AI assistants read-only access to your Azure cost data. Ask about spending, find anomalies, get optimization recommendations, and forecast next month's bill — all through natural language.
Supported Providers
| Provider | Status |
|---|---|
| Azure | ✅ Supported |
| GCP | Coming soon |
| AWS | Use AWS's official server |
Prerequisites
- Azure CLI installed and logged in (
az login) - Your subscription ID (
az account show --query id -o tsv) - Cost Management Reader role on the subscription
Configuration
Add to your MCP client config (claude_desktop_config.json, Cursor settings, etc.):
{
"mcpServers": {
"cloudscope": {
"command": "npx",
"args": ["-y", "cloudscope-mcp"],
"env": {
"AZURE_SUBSCRIPTION_ID": "your-subscription-id"
}
}
}
}
No service principal needed for local development. DefaultAzureCredential picks up your az login session automatically.
| Variable | Description |
|---|---|
AZURE_TENANT_ID |
Azure AD tenant ID |
AZURE_CLIENT_ID |
App registration client ID |
AZURE_CLIENT_SECRET |
App registration client secret |
Set these alongside AZURE_SUBSCRIPTION_ID in the env block above.
Tools
| Tool | Description | Key Parameters |
|---|---|---|
get_cost_summary |
Spending breakdown by service, group, or region | start_date, end_date, group_by |
detect_anomalies |
Find spending spikes vs previous period | days, threshold |
list_recommendations |
Azure Advisor cost optimization suggestions | category |
get_cost_forecast |
Predict spending based on current trends | days |
check_budgets |
Budget status, current spend, projected overage | (none) |
compare_periods |
Side-by-side cost comparison of two date ranges | period_a_start/end, period_b_start/end |
top_spending_resources |
Most expensive individual resources | days, limit |
get_current_date |
Today's date and current/previous month bounds | (none) |
Example Prompts
- "How much did Azure cost last month?"
- "Show spending by resource group for the last 7 days"
- "Any cost anomalies this week?"
- "What will Azure cost next month?"
- "Show me cost optimization recommendations"
- "Which services had the biggest spend increase?"
Security
CloudScope is read-only. It cannot create, modify, or delete any Azure resources. All API calls use Cost Management Reader permissions with no write access.
FAQ
Does this modify my Azure resources? No. Read-only access only.
Do I need a service principal? No. az login works for local use.
What about GCP? Coming soon.
Does the Azure Cost Management API cost money? No. It's free.
Development
git clone https://github.com/alexpota/cloudscope-mcp.git
cd cloudscope-mcp
npm install
npm run build
npm test
npx @modelcontextprotocol/inspector node dist/index.js
License
MIT
