Skip to main content
Forecast categories are the columns of your forecast grid (Commit, Best Case, Pipeline, etc). Each category defines how it contributes to the forecast total, where it sits in the grid, and whether it’s computed from the CRM or driven by user input. System-managed categories (like CRM-derived totals) only allow updates to their description and inclusion flag — the rest is computed.

​
Tools

​
get_forecast_config

Scope: mcp:read. No parameters.
Get the forecast categories configured for your organization, including column types, display order, and visibility settings. Returns: Markdown list of forecast categories with label, ID, column key, type, display order, color, visibility, and whether they’re system-managed.

​
create_forecast_category

Scope: mcp:write. Requires admin role.
Create a new forecast category column.
​
string
required
Unique column key identifier (e.g. commit, upside).
​
string
required
Display label for the category.
​
string
Description or tooltip text.
​
string
Column type: system, call, or deal_rollup (default: deal_rollup).
​
integer
Display order position.
​
string
UI accent color (e.g. #00FF00).
​
boolean
Whether this category contributes to the forecast total.

​
update_forecast_category

Scope: mcp:write. Requires admin role.
Update an existing forecast category. System-managed categories only accept updates to description and include_in_call.
​
string
required
The UUID of the forecast category to update.
​
string
New display label.
​
string
New description.
​
boolean
Whether this contributes to the forecast total.
​
integer
New display order position.
​
string
New UI accent color.
​
boolean
Whether this category is visible in the forecast grid.