Docs: Tool reference
planning toolset

configure_scoring

Configure roadmap scoring. Adds, changes or removes a roadmap's scoring factors, then rescores it. Each entry in factors matches an existing factor by id or name (and updates it) or adds a new one (name and source required). Impact factors raise the score, effort factors lower it; weights set their share. Manual factors take values from set_factor_values. The Votes factor can't be removed (set weight 0). Nobody is emailed. Managers and owners.

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

Input

FieldTypeDescription
roadmaprequiredstringThe roadmap's name or ID (rdm_…).
factorsarray of object
removearray of stringFactor names or IDs.
expected_versionintegerThe roadmap's version from your last read; the call fails if it changed since.

Output

FieldTypeDescription
roadmaprequiredobject
addedrequiredarray of string
updatedrequiredarray of string
removedrequiredarray of string

Calling it

// MCP: tools/call
{ "name": "configure_scoring", "arguments": {"roadmap":"<string>"} }

// Typed client
await carechannel.configure_scoring({"roadmap":"<string>"});