Skip to main content
Glama

Change a tool document

tools_apply_commands
Destructive

Change one document in any builder: roadmap (Outcome-Based Roadmap), roi (ROI Calculator), noice (NOICE Prioritization), ost (Opportunity Solution Tree), usm (User Story Map), vsm (Value Stream Map), cfd (Cumulative Flow Diagram), wardley (Wardley Map). Apply up to 25 commands as one atomic batch: all apply or none do. Read the document with tools_get_document first. It returns the toolKey to pass here, the version to pass as expectedVersion, and the commands that builder takes, each with its fields. A later command may name an entity an earlier one created only if you supplied no ids; read the result for the ids it assigned. StartOver clears a document, and RestoreTo with an event id from tools_get_history puts it back to that point. Send the same batchId again to retry safely after a timeout.

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": {
      "toolKey": "<toolKey>",
      "documentId": "<documentId>",
      "expectedVersion": "<expectedVersion>",
      "commands": "<commands>"
    },
    "name": "tools_apply_commands"
  }
}

Input Schema

NameRequiredDescriptionDefault
batchIdNoYour id for this batch. Repeating it returns the stored result instead of writing twice.
toolKeyYesThe document's toolKey, from tools_get_document.
commandsYesCommands from the document's catalog in tools_get_document: each one is its type plus that command's fields.
documentIdYesThe document id, from tools_list_documents.
expectedVersionYesThe version you last read from tools_get_document. A stale version returns a conflict with what changed.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources