Set Up AI Hub

Connect AI Hub to your CloudZero account and start asking questions about your costs. Choose the setup path that fits your AI tool:

PathBest forWhat it does
Option A: Claude Code PluginClaude Code usersInstalls the MCP server and guided analysis skills in one command
Option B: Other tools quick installCursor, VS Code, Codex, and other supported toolsAdds the MCP server with a single npx command
Option C: Manual configurationMCP-compatible AI toolsConfigures the MCP server connection directly

Option A: Connect with the CloudZero Plugin for Claude Code

The fastest way to get started. The Claude Code Plugin bundles the CloudZero MCP server with guided analysis skills in a single install.

What you need

  • A CloudZero account
  • Claude Code (v2.1 or above). If you do not have Claude Code installed, visit Anthropic's Claude Code installation guide, select your operating system and preferred install method, and follow the steps. Once claude is available in your terminal, return here to continue.
  • (Recommended) A dedicated folder for your cost analysis work (for example, cloudzero-cost-analysis). Navigate to this folder in your terminal before starting claude.
ℹ️

The CloudZero Plugin is supported through the Claude Code CLI. This is separate from claude.ai and Claude Desktop.

Install

  1. Run the following commands to install the plugin:

    claude plugin marketplace add cloudzero/cloudzero-claude-marketplace
    claude plugin install cost-analyst@cloudzero
  2. Start a Claude Code session by running claude in your terminal.

  3. Run /mcp and select plugin:cost-analyst:cloudzero from the list.

  4. Follow the instructions to sign in to CloudZero.

  5. After signing in to CloudZero, run the following command to teach Claude about your Dimensions, cloud configurations, and organization context. This improves the accuracy and relevance of every query.

    /plugin:cost-analyst:cloudzero:init
  6. You are ready to start querying. Try one of the examples below.

Connect

To start a new session:

  1. Navigate to your cost analysis folder and run claude in your terminal.
  2. Run /mcp and select plugin:cost-analyst:cloudzero from the list.
  3. Sign in to CloudZero when prompted. If you already have an active session, authentication is automatic.

Option B: Quick install for other MCP-compatible AI tools

Install the CloudZero MCP server into any supported AI tool with a single command using npx add-mcp.

What you need

  • A CloudZero account
  • Node.js (v18 or later)

Install with npx

Run the install command for your AI tool:

AI toolInstall command
Antigravitynpx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a antigravity -y
Claude Codenpx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a claude-code -y
Cline (VS Code)npx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a cline -y
Cline CLInpx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a cline-cli -y
Codexnpx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a codex -y
Cursornpx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a cursor -y
Gemini CLInpx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a gemini-cli -y
GitHub Copilot CLInpx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a github-copilot-cli -y
Goosenpx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a goose -y
MCPorternpx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a mcporter -y
OpenCodenpx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a opencode -y
VS Codenpx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a vscode -y
Zednpx add-mcp https://czca-server.discovery.cloudzero.com/mcp -g -a zed -y
ℹ️

These commands install the MCP server to the tool's global configuration. To install to a project-level configuration instead, remove the -g flag. For the most updated list of supported tools and commands, see the npx add-mcp documentation.

Install for Kiro

Kiro uses its own install command. For details, see the CloudZero Kiro Power repository.

kiro /powers install cloudzero

Connect

Open your AI tool and invoke any CloudZero tool. On first use, a browser window opens to sign in to CloudZero. If you already have an active session, authentication is automatic.

Option C: Manually connect an AI tool via MCP

Use this path if your AI tool is not listed above or you want full control over your MCP configuration.

Install

Add the CloudZero MCP server to your AI tool's configuration using the following values:

SettingValue
Server namecloudzero
URLhttps://czca-server.discovery.cloudzero.com/mcp
Typehttp
AuthenticationOAuth (a browser window opens on first use). For API key authentication, see API Key Authentication.

Most AI tools accept this as a JSON configuration block:

{
  "mcpServers": {
    "cloudzero": {
      "type": "http",
      "url": "https://czca-server.discovery.cloudzero.com/mcp"
    }
  }
}

Refer to your AI tool's documentation for where to add MCP server configurations.

Connect

On first use with OAuth, a browser window opens to sign in to CloudZero. If you already have an active session, authentication is automatic.

What to expect

After setup, you can start querying your cost data immediately. AI Hub accesses your full CloudZero data model, including the custom business logic in your Dimensions, optimization recommendations, and data from every connected provider. The same spend intelligence your team has built in CloudZero is available through natural language.

Examples of prompts you can ask

  • "We had a cost spike last Tuesday. Investigate what caused it and recommend actions"
  • "Do a deep dive on our RDS costs and identify optimization opportunities"
  • "Generate a cost breakdown by team for Q4 including service details"
  • "Analyze our tag coverage and prioritize resources that need tagging"
  • "Run an anomaly detection scan, then show me my top cost drivers and any trends"

For more prompts organized by role and use case, see the Prompt Catalog.

ℹ️

Have questions or feedback? Reach out to your account manager.