Skip to main content
Superblocks gives administrators full control over GAU spending. From the Spend Management page in your organization settings, you can set organization-wide caps, assign per-user budgets, and monitor usage, ensuring your team stays productive without unexpected costs. Spend Management is available on Enterprise and Teams plans. Spend Management overview

​
Usage visibility

The Spend Management page provides detailed visibility into how GAUs are consumed across your organization:
  • Per-user usage: See which team members are consuming the most GAUs
  • Per-application usage: Track GAU consumption by application, helping you identify which projects drive the most AI usage and allocate resources effectively
This granular visibility helps you make informed decisions about budget allocation and identify opportunities for optimization.

​
Spend limits

Spend limits prevent unexpected charges by capping usage at both the organization and individual user level. You can set org-wide overage spending limits, which are enforced based on your plan’s billing cycle (monthly or annual). You can also set monthly per-user spend limits. Both budgets reset automatically at the start of each period.

​
Maximum GAU overage

Enterprise organizations can set an overage cap - the maximum additional usage your team can consume beyond your contractual commit. This is your primary guardrail against runaway spending if your team exceeds your committed usage. Setting a maximum overage limit

​
Default per-user limit

Set a default GAU allowance that applies to every user in your organization. This is the maximum number of GAUs any individual user can consume per month. Per-user limits always reset monthly, regardless of your plan’s billing cycle.
  1. In the Spend limits section, click + next to Default per-user limit
  2. Enter the GAU limit
  3. The limit takes effect immediately for all users without a custom override

​
Custom per-user limits

Override the default limit for specific users who need more (or fewer) GAUs.
  1. Click + next to Custom per-user limits
  2. Select a user from the dropdown — including pending invitees who haven’t accepted yet
  3. Set their individual GAU limit
Custom limits take precedence over the default. When a user with a pending invite accepts, their pre-configured limit applies immediately — no additional admin action needed. Spend Limits with configured overage and per-user budgets Adding a custom per-user limit
For Enterprise contracts denominated in dollars (dollar commit), all limits and usage displays are shown in dollar amounts instead of GAUs.

​
What happens when a limit is reached

When a user or organization reaches a configured spend limit:
  • AI-powered features (Clark and other AI interactions) are paused for the affected scope
  • Users see a notification explaining that their GAU limit has been reached
  • Administrators can increase limits or purchase additional GAUs to resume usage
  • Limits reset automatically at the start of each period (monthly for per-user limits; your billing cycle for the org-wide overage cap)

​
Programmatic spend management via MCP

You can monitor spending and configure limits programmatically using the Superblocks MCP server. This is useful for automated monitoring, integrating with internal tools, or managing limits at scale.

​
Available tools

All billing MCP tools require the billing:manage permission.

​
Example: Check current usage

Ask your AI coding agent:
The agent will call get_billing_plan_summary and return your current usage, remaining GAUs, and billing cycle dates.

​
Example: Set a per-user limit

The agent will call update_user_billing_usage_limit with is_default: true and credit_limit: 50.
The agent will call get_billing_usage_daily with the appropriate date range and return a breakdown of daily consumption.

​
Spending notifications New

Spend alerts notify administrators by email when usage approaches configured thresholds, so you can take action before hitting a billing surprise. Configure alerts from the Spend alerts section at the bottom of the Spend Management page.
Spend alerts are rolling out progressively. If you don’t see the Spend alerts section on your Spend Management page, contact support to have it enabled for your organization.

​
Alert types

Superblocks supports four alert types. The types available to your organization depend on your plan:
Enterprise contracts denominated in dollars (dollar commit) display all thresholds and usage in dollar amounts instead of GAUs.

​
Configuring alerts

  1. Navigate to Organization Settings > Spend Management
  2. Scroll to the Spend alerts section
  3. Click + Add alert
  4. Choose an alert type — only types available on your plan are shown
  5. Set one or more thresholds (for example, notify at 80% and 100% of your allocation)
  6. Save the alert
Alerts are evaluated in real time as usage is recorded. When a threshold is crossed, an email is sent to all organization administrators. Each threshold fires at most once per billing cycle — it re-arms automatically when a new cycle begins.

​
Threshold units

The units available depend on the alert type:
  • Organization spend: percentage of allocation, GAUs used, or GAUs remaining
  • Per-user spend: GAUs consumed by a single user
  • Overage spend: overage GAUs consumed (or dollars, on dollar-commit plans)
  • Refill spend: GAUs or dollars spent on refills

​
Delivery

Spend alerts are delivered via email to all organization administrators. Per-user spend alerts also notify the individual user who triggered the threshold.