Docs: Tool reference
planning toolset

set_factor_values

Set manual factor values. Sets manual factor values (such as Effort or Confidence) for posts on a roadmap, then rescores it. Each value names a post, a manual factor and a value on that factor's scale (checkbox takes true or false; null clears). Up to 200 values per call. Posts must already be on the roadmap. Nobody is emailed. Managers and owners.

Toolset
planning
Who can call it
OwnersManagersAPI keys
REST
POST /api/v1/w/{workspace}/roadmaps/{roadmap}/values
Behavior
changes dataidempotent

Input

FieldTypeDescription
roadmaprequiredstringThe roadmap's name or ID (rdm_…).
valuesrequiredarray of object

Output

FieldTypeDescription
roadmaprequiredobject
changedrequiredarray of object

Calling it

// MCP: tools/call
{ "name": "set_factor_values", "arguments": {"roadmap":"<string>","values":"<array of object>"} }

// Typed client
await carechannel.set_factor_values({"roadmap":"<string>","values":"<array of object>"});