CloudZero

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

python

4

GitHub Stars

python

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "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.