CloudScope MCP

Ask your AI about your cloud bill.

Install

Claude Code	Cursor	VS Code
claude mcp add cloudscope -e AZURE_SUBSCRIPTION_ID=your-subscription-id -- npx -y cloudscope-mcp	Install	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. Includes four guided-workflow prompts for common tasks (monthly reviews, waste audits, spike investigations, executive summaries).

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.

Advanced: Service Principal (CI/CD & automated environments)

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)

Prompts

Guided workflows that produce structured reports. In Claude Code, type /cloudscope: to see all prompts. In Claude Desktop, click the + button → Connectors → cloudscope. Other MCP clients surface prompts differently — check your client's docs.

Prompt	Description	Arguments
monthly-cost-review	Complete monthly review: spending, last-month comparison, anomalies, top resources, budgets, forecast, savings opportunities	(none)
waste-audit	Find wasted spend: top expensive resources, Azure Advisor recommendations, at-risk budgets, total potential savings	(none)
cost-spike-investigation	Root-cause analysis for a cost increase: which services, which resources, trend vs one-time, recommended actions	days (optional, default 7)
executive-summary	Brief non-technical cost summary for leadership: spend, trend, budget status, top drivers, forecast, key recommendation	(none)

Example Questions

• "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