Get Sales Forecast
get_forecastAnswer sales forecast questions for a week, month, or quarter using forecast summaries, open pipeline, and won actuals. Use it for forecast reviews and team or rep comparisons. Use get_deals for individual deals behind the totals. Won actuals follow pipeline, owner, and close-date scope; open-stage filters apply only to open pipeline.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"date_range": "<date_range>"
},
"name": "get_forecast"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| group_by | No | month | |
| team_ids | No | Exclusive selector: non-empty exact team IDs, expanded to active owners. Use instead of owner_scope or owner_ids. | |
| owner_ids | No | Exclusive selector: non-empty exact IDs from the owners catalog. Use instead of owner_scope or team_ids. | |
| date_range | Yes | Required explicit forecast period. | |
| owner_scope | No | Exclusive selector: all owners or current authenticated user. Omitting all three owner selectors defaults to all workspace owners. | |
| pipeline_stages | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| kind | Yes | ||
| tool | Yes | ||
| summary | Yes | ||
| result_id | No | ||
| limitations | No |