Set Up AI Hub

Connect AI Hub to your CloudZero account and start asking questions about your costs. CloudZero hosts the MCP server, so you always connect to the current version. New MCP server tools and fixes reach you without a reinstall. Choose the setup path that fits your AI tool:

Connecting an enterprise agent platform such as Amazon Bedrock AgentCore or Google Gemini Enterprise takes a different path, because those platforms need credentials issued in advance. See Connect an Agent Platform with MCP OAuth Clients.

Option A: Connect with the CloudZero Plugin for Claude Code

The fastest way to get started. The Claude Code Plugin connects you to the CloudZero MCP server and installs guided analysis skills in one command.

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.

Install

1. Run the following commands to install the plugin:
   Bash

   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 generate organization context from your recent query history: what your Dimensions mean, common analysis workflows, and cost allocation patterns. This improves the accuracy and relevance of every query. Run it again any time to refresh the generated context. It does not change the Custom Instructions you have added, so rules you give the agent persist across runs. For details, see Context tools in the MCP Server Reference.

   Bash

   /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 setup for other MCP-compatible AI tools

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

What you need

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

Add with npx

Run the add command for your AI tool:

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.

Configure

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

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.