Browse documentation

analyze_change_impact

[callgraph]

Summarizes references, callers, exported API usage, and dependent projects affected by a symbol change.

Try it locally in the TGlider playground

Parameters

NameTypeRequiredDescription
symbolKeystringNoStable symbol key returned by a prior symbol discovery tool. Pass this or symbolKeys.
symbolKeysjsonNoSeveral symbol keys, answered in one call. Use the keys changed_symbols returns for a diff.
scopestringNoImpact scope: 'same-project', 'direct-dependents', or 'transitive-dependents'. Default: "direct-dependents"
maxExamplesPerGroupnumberNoMaximum examples to include per impact group.
takenumberNoMaximum number of matching results to return.

Examples

Replace sample paths and symbol keys with values from your workspace.

Plan impact before editing an exported API

Arguments
{
  "symbolKey": "role=canonical|...",
  "scope": "direct-dependents"
}
Full MCP request
Full MCP request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "analyze_change_impact",
    "arguments": {
      "symbolKey": "role=canonical|...",
      "scope": "direct-dependents"
    }
  }
}

Response Notes

Returns references, callers, API exposure, dependent projects, diagnostics risk, and next-tool hints. With symbolKeys it returns counts per symbol plus totals. It also lists any key that did not resolve. Pass a single symbolKey for the detail of one symbol.