CloudScope MCP

Ask your AI about your cloud bill.

npm version Node.js TypeScript License: MIT

Install

Claude Code	Cursor	VS Code
`claude mcp add cloudscope -- 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.

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