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.

| 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