home / mcp / cloudzero mcp server

CloudZero MCP Server

Talk to your cloud data using CloudZero API and Model Context Protocol (MCP) server for LLM tool calling

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "burkestar-cloudzero-mcp": {
      "command": "/Users/USERNAME/.local/bin/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/Users/USERNAME/workspace/open_source/cloudzero-mcp/server.py"
      ],
      "env": {
        "CLOUDZERO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can query and analyze your CloudZero cost data directly from a Large Language Model (LLM) using the CloudZero MCP server. It exposes cost data through the MCP protocol so you can ask questions, fetch billing data over date ranges, and list budgets or insights in a conversational workflow.

How to use

You use the CloudZero MCP server by configuring it in your MCP client and starting it as a background process. Once active, your MCP client will communicate with the server using JSON-RPC 2.0. The server exposes tools that let you fetch costs for a date range, retrieve billing dimensions, list budgets, and list insights. Start by ensuring your MCP client is aware of the CloudZero server, then perform queries like: get costs for a given window, ask for available dimensions, or request a list of insights to guide cost optimization.

How to install

Prerequisites you need before installation include a compatible MCP runner and runtime environment. You will install the MCP server support for CloudZero, initialize your workflow, and configure authentication to access CloudZero data.

uv init
uv sync
```

Generate your CloudZero API key and save it in a secure environment file for use by the MCP server.

Additional setup and configuration

Configure authentication by creating an environment file and setting CLOUDZERO_API_KEY to your secret key. This key authorizes requests to the CloudZero v2 API.

CLOUDZERO_API_KEY=YOUR_SECRET_KEY

Install the MCP server into Claude Desktop

Install the MCP server module and ensure Claude Desktop can launch it as a background process. Then adjust the client configuration to point to the CloudZero MCP server command so Claude Desktop starts the server on launch.

Debug and troubleshooting

If you encounter startup errors, open the logs in Claude Desktop to diagnose issues. Common problems include missing environment variables, misconfigured paths, or API key errors. Run the development server with debugging enabled to inspect the server’s behavior and fix issues incrementally.

Available tools

get_costs

Fetch billing data from a specified start date to an end date, returning costs for that period.

get_dimensions

Retrieve available billing dimensions to inform how costs can be sliced and analyzed.

list_budgets

List all defined budgets in your CloudZero account.

list_insights

List available insights related to your cost data to guide optimization and analysis.