AI Hub Troubleshooting

Solutions for common issues when setting up or using AI Hub. For setup instructions, see Set Up AI Hub.

Authentication failed

Symptoms: authentication errors, "Unauthorized" responses, unable to load organization context

Solutions:

1. Log in to the CloudZero platform directly to verify your account access.
2. Clear cookies for cloudzero.com in your default browser and try again.
3. Restart your AI tool to trigger fresh authentication.

Plugin not found

Symptoms: "Plugin not found" when trying to install the Claude Code Plugin

Solutions:

1. Add the marketplace first:
   Bash

   claude plugin marketplace add cloudzero/cloudzero-claude-marketplace

2. Then install the plugin:
   Bash

   claude plugin install cost-analyst@cloudzero

No data returned

Symptoms: "No cost data found" or empty results

Solutions:

1. Try a different time range. Verify data exists for the period in the CloudZero platform.
2. Broaden your filters. Remove specific service or account filters.
3. Recent cost data takes 24-48 hours to appear after connecting a new provider.

Response too large

Symptoms: "produced a response of X.X MB, which exceeds the 5 MB limit"

Solutions:

1. Narrow the date range (for example, last 7 days instead of last 90 days).
2. Add filters to scope the query to specific accounts, services, or teams.
3. Ask for fewer results or group by a broader category.

AI agents that receive this error retry with a narrower query automatically. For the underlying limits, see MCP Server Reference.

Quota exceeded

Symptoms: "Daily API key organization quota exceeded"

This applies to API key authentication only. OAuth users are not metered.

Solutions:

1. The quota resets at midnight UTC. Wait and try again after the reset.
2. If you consistently reach the daily limit, contact your account manager.

For details on quota thresholds and warnings, see MCP Server Reference.