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
| Name | Type | Required | Description |
|---|---|---|---|
| symbolKey | string | No | Stable symbol key returned by a prior symbol discovery tool. Pass this or symbolKeys. |
| symbolKeys | json | No | Several symbol keys, answered in one call. Use the keys changed_symbols returns for a diff. |
| scope | string | No | Impact scope: 'same-project', 'direct-dependents', or 'transitive-dependents'. Default: "direct-dependents" |
| maxExamplesPerGroup | number | No | Maximum examples to include per impact group. |
| take | number | No | Maximum 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.