Agent usage & billing
Agent usage & billing
Every Mantle plan includes a set number of agent runs. This guide explains how to monitor your usage and manage your billing settings.
Understanding agent runs
An agent run is counted each time an agent executes in response to a trigger—whether that's a customer action, a scheduled event, or a manual invocation from a flow. Each plan includes a base allocation of runs, and you can use additional runs beyond your plan's included amount.
Viewing your usage
To check your current agent usage:
- Go to Settings in your Mantle dashboard
- Click on Billing
- You'll see your current usage for the billing period, including:
- Total runs used
- Runs included in your plan
- Any additional runs consumed
Setting a usage limit
To help manage costs, you can set a limit on how many additional runs your agents can use beyond your plan's included amount:
- Go to Settings → Billing
- Find the Usage limit section
- Set your desired maximum for additional runs
- Click Save
When your usage approaches the limit, you'll receive a notification. Once the limit is reached, agents will pause until the next billing cycle or until you increase your limit.
Overage billing
If you use more runs than your plan includes and haven't set a usage limit (or your limit allows for overages), you'll be charged for the additional runs at your plan's overage rate. Overage charges are calculated at the end of each billing cycle and added to your next invoice.
Tips for managing usage
- Monitor regularly: Check your usage weekly to understand your patterns
- Set conservative limits initially: Start with a lower limit and adjust as you learn your typical usage
- Optimize your agents: Review agent configurations to ensure they're running efficiently and only when needed
- Use flow conditions: Add conditions to your flows to prevent unnecessary agent runs