Superblocks gives administrators full control over AI credit 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.Documentation Index
Fetch the complete documentation index at: https://docs.superblocks.com/llms.txt
Use this file to discover all available pages before exploring further.
Credits balance
The credits balance tile shows your organization’s current usage against your contracted credit allocation at a glance:- Total credits used this billing cycle
- Remaining credits from your plan allocation
- A visual progress bar showing consumption against your plan
Spend limits
Spend limits prevent unexpected charges by capping usage at both the organization and individual user level. Limits are enforced per billing cycle and reset automatically.Maximum credit overage
Enterprise organizations can set an overage cap — the maximum number of extra credits your team can consume beyond the contracted plan allocation. This is your primary guardrail against runaway spending if your team exceeds the included credits.Default per-user limit
Set a default credit allowance that applies to every user in your organization. This is the maximum number of credits any individual user can consume per billing cycle.- In the Spend limits section, click + next to Default per-user limit
- Enter the credit limit
- 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) credits.- Click + next to Custom per-user limits
- Select a user from the dropdown — including pending invitees who haven’t accepted yet
- Set their individual credit limit
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 credit limit has been reached
- Administrators can increase limits or purchase additional credits to resume usage
- Limits reset automatically at the start of each billing cycle
Spend limits only affect AI credit consumption. Other Superblocks features (building apps, deploying, managing integrations) are not impacted.
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
| Tool | Description |
|---|---|
get_billing_plan_summary | Get current plan details including credit allocation, usage, billing cycle dates, and deployed app counts |
get_billing_usage_daily | Get daily AI credit usage for a date range — one row per day with total credits consumed |
get_billing_usage_records | Get per-user AI credit usage records for a date range, including top consumers |
list_billing_usage_limits | View all configured spend limits — organization-wide and per-user |
update_org_billing_usage_limit | Set or update the organization-wide credit overage cap |
update_user_billing_usage_limit | Set or update a per-user credit limit, or configure the default limit for all users |
billing:manage permission.
Example: Check current usage
Ask your AI coding agent:get_billing_plan_summary and return your current usage, remaining credits, and billing cycle dates.
Example: Set a per-user limit
update_user_billing_usage_limit with is_default: true and credit_limit: 50.
Example: Monitor daily usage trends
get_billing_usage_daily with the appropriate date range and return a breakdown of daily consumption.
Spending notifications Coming soon
Superblocks will soon support spending notifications to alert administrators when usage approaches configured limits. Notifications will help you:- Get alerted before your team hits a spend limit
- Receive weekly or monthly usage summaries
- Get notified when individual users approach their per-user budget
- Set custom threshold alerts (e.g., notify at 80% of budget)