Cloudzero Model Context Protocol (MCP) server

Cloudzero Model Context Protocol (MCP) server

By burkestar GitHub

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

Overview

What is Cloudzero Model Context Protocol (MCP)?

Cloudzero MCP is a server that allows users to interact with their cloud cost data using the CloudZero API and Model Context Protocol (MCP) for Large Language Model (LLM) tool calling.

How to use Cloudzero MCP?

To use Cloudzero MCP, install Claude Desktop and the necessary dependencies, generate a CloudZero API key, and configure the server settings in the Claude Desktop configuration file. Once set up, you can ask questions about your cloud billing and cost data.

Key features of Cloudzero MCP?

  • Integration with CloudZero v2 API for cloud cost data access
  • Ability to ask questions about cloud billing and visualize cost data
  • Debugging tools for troubleshooting and inspecting server processes

Use cases of Cloudzero MCP?

  1. Analyzing cloud spending trends over time.
  2. Generating reports on cloud cost data.
  3. Debugging and troubleshooting cloud cost-related issues.

FAQ from Cloudzero MCP?

  • What is required to set up Cloudzero MCP?

You need to install Claude Desktop, set up the project dependencies, and generate a CloudZero API key.

  • Can I visualize my cloud cost data?

Yes! You can ask questions to plot month-over-month differences in your cloud spending.

  • Is there a debugging feature available?

Yes, you can run the MCP development server with an interactive GUI for debugging.

Content

Cloudzero Model Context Protocol (MCP) server

Talk to your cloud cost data in Cloudzero from a Large Language Model (LLM).

Ask questions about your cost data such as plotting a month over month difference:

monthly diff

How it works

Uses CloudZero v2 API and the Model Context Protocol MCP.

graph LR
    %%{init: {'theme':'neutral'}}%%
    %% Define nodes
    A[MCP Host]
    B[Local MCP Server]
    C[CloudZero API]
    D[(Cloud Costs Data)]

    %% Define connections
    A -->|JSON-RPC 2.0| B
    B -->|HTTP/JSON| C
    C <--> D

    subgraph CloudZero_SaaS
    C
    D
    end

    subgraph Background_process
    B
    end

    subgraph Claude_Desktop
    A
    end

    subgraph Local_Machine
    Claude_Desktop
    Background_process
    end

    %% Define styles
    classDef client padding:10px
    classDef server padding:10px
    classDef api padding:10px
    classDef db padding:10px

    %% Apply styles
    class A client
    class B server
    class C api
    class D db

Once the MCP server is configured in Claude Desktop, it will be launched as a background process at startup. Claude Desktop as the MCP Host will send an initiatize request to the MCP Server. The server responds with its capabilities, which includes prompts and tools for tool calling.

The server implements several tools specific to CloudZero:

  • get_costs to get billing data from start_date to end_date
  • get_dimensions for billing dimensions
  • list_budgets to list budgets
  • list_insights to list insights

The MCP protocol uses JSON-RPC 2.0 for requests and responses.

Setup

Install Claude Desktop:

Install uv

Setup the project dependencies:

uv init
uv sync

Generate your CloudZero API key.

Edit .env with:

CLOUDZERO_API_KEY=YOUR_SECRET_KEY

Install

To install the MCP server into Claude Desktop:

uv run mcp install server.py

Edit your claude_desktop_config.json to set the proper path to the uv command and update your USERNAME as below.

This config file can be located in Claude Desktop under Settings > Developer > Edit Config.

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

Restart Claude Desktop. When the Desktop starts, it will launch the server process in the background. You may see errors, and can drill into the logs to see what the problem is.

If no errors, try asking "what tools are available for cloud billing" to see it listed.

which tools available

See Claude Desktop MCP documentation for more info.

Debug

For debugging, you can run the MCP development server with an interactive GUI to inspect:

uv run mcp dev server.py

This is useful for troubleshooting bugs in your code without having to continuously restart Claude Desktop.

mcp inspector

No tools information available.
No content found.