Skip to main content
Use these tools when search results feel sparse, or when you need richer process metadata than fetch returns.
ToolWhen to use
search_processesRanked process search combining keyword matches (name, objective, team, value stream) with semantic similarity. Returns mixed hierarchy-node + process results — use when a top-level value stream or department might be a better starting point than a leaf process.
get_process_hierarchyBrowse the whole index structure. Use when search misses, or to orient before drilling in. Cap depth with max_depth; the response flags truncated branches and points you at the next call.
get_hierarchy_node_detailsInspect a single hierarchy node — parent, children, linked process, attributes. The right call for a folder / group / value stream key.
get_process_detailsThe rich nested payload for a process: current_version, dependencies, hierarchy_node, attributes, optional version history. Default returns a summary with operational attributes; pass scope to include tasks, observations, dependencies, linked_artifacts, policies, or history. This is what fetch reshapes — use directly when you need the structured shape.

​
Choosing among the lookup tools

  • Semantic + keyword, broad → search (entry point) or search_processes (richer, mixed results)
  • You have a resource key → get_process_details (for processes) or get_hierarchy_node_details (for folders / groups / value streams)
  • Browse / orient → get_process_hierarchy, then drill in with get_hierarchy_node_details or get_process_details
  • Drill further (what actually happened on a specific process) → get_process_observations → get_observation_citation. See Process observations for the full toolset.

​
Common chains

  • “What’s in this value stream?” → get_process_hierarchy (broad) → get_hierarchy_node_details on the relevant node → get_process_details on each leaf
  • “Pull every dependency of process X” → get_process_details with scope=["dependencies"] → walk the dependencies list with further get_process_details calls
  • “I have a resource key, give me everything” → get_process_details with the scopes you care about (tasks, linked_artifacts, history)
  • “What actually happens when this process runs?” → get_process_details → get_process_observations → get_observation_citation on a representative deviation