Capacity Utilization
Capacity Utilization: Billable hours sold vs available. Hours booked are the budgeted hours on sold projects.
Formula
Capacity Utilization = Hours booked / Capacity × 100 Computable definition
The canonical formula in the GASP formula grammar. The MCP server compiles it to SQL over the datasets listed below.
sum(field.hours_budgeted) / metric.capacity Unit: percent (the formula yields an unscaled ratio)
Notes: Hours booked is taken as budgeted hours on sold projects.
Data requirements
Grain: Weekly aggregate · Frequency: Weekly · Aggregation: aggregate (week) · Staged: no · Main source: PSA.
| Field | Dataset | Type |
|---|---|---|
available_hours | consultant | decimal |
hours_budgeted | project | decimal |
period_start | consultant | date |
snapshot_date | project | date |
Example SQL (Postgres)
SELECT (CAST((SELECT COALESCE(SUM(hours_budgeted), 0) FROM project WHERE snapshot_date = :period_end) AS DOUBLE PRECISION) / NULLIF(((SELECT COALESCE(SUM(available_hours), 0) FROM consultant WHERE period_start >= :period_start AND period_start <= :period_end)), 0)) AS capacity_utilization From an agent: with the GASP MCP server, call
lookup_metric({ "name": "Capacity Utilization" }) or generate_query({ "metric": "Capacity Utilization", "adapter": "<your adapter JSON>" }).