MCP Tools
All 18 tools are auto-approved and available to Kiro once installed. The MCP server is started by Kiro automatically when needed.
kirograph_context
Comprehensive context for a task or feature, often sufficient alone without additional tool calls. Uses vector search on every call.
| Parameter | Type | Default | Description |
|---|---|---|---|
task | string | required | Task, bug, or feature description |
maxNodes | number | 20 | Max symbols to include |
includeCode | boolean | true | Include code snippets |
projectPath | string | cwd | Project root path |
kirograph_search
Quick symbol search by name. Returns locations only, no code. Vector search only as last resort.
| Parameter | Type | Default | Description |
|---|---|---|---|
query | string | required | Symbol name or partial name |
kind | string | — | Filter: function, method, class, interface, type_alias, variable, route, component |
limit | number | 10 | Max results (1–100) |
projectPath | string | cwd | Project root path |
kirograph_callers
Find all functions/methods that call a specific symbol. BFS traversal of incoming call edges.
| Parameter | Type | Default | Description |
|---|---|---|---|
symbol | string | required | Symbol name |
limit | number | 20 | Max results (1–100) |
projectPath | string | cwd | Project root path |
kirograph_callees
Find all functions/methods that a specific symbol calls. BFS traversal of outgoing call edges.
| Parameter | Type | Default | Description |
|---|---|---|---|
symbol | string | required | Symbol name |
limit | number | 20 | Max results (1–100) |
projectPath | string | cwd | Project root path |
kirograph_impact
Analyze what code would be affected by changing a symbol. Use before making changes. BFS traversal of all incoming edges.
| Parameter | Type | Default | Description |
|---|---|---|---|
symbol | string | required | Symbol name |
depth | number | 2 | Traversal depth |
projectPath | string | cwd | Project root path |
kirograph_node
Get details about a specific symbol: kind, name, qualified name, file location, signature, docstring, and optionally source code.
| Parameter | Type | Default | Description |
|---|---|---|---|
symbol | string | required | Symbol name |
includeCode | boolean | false | Include source code |
projectPath | string | cwd | Project root path |
kirograph_type_hierarchy
Traverse the type hierarchy of a class or interface. Recursive traversal of extends/implements edges.
| Parameter | Type | Default | Description |
|---|---|---|---|
symbol | string | required | Class or interface name |
direction | string | both | up (base types), down (derived types), both |
projectPath | string | cwd | Project root path |
kirograph_path
Find the shortest path between two symbols in the dependency graph. Undirected BFS across all edge types.
| Parameter | Type | Default | Description |
|---|---|---|---|
from | string | required | Source symbol name |
to | string | required | Target symbol name |
projectPath | string | cwd | Project root path |
kirograph_dead_code
Find symbols with no incoming references (potential dead code). Only unexported symbols are considered.
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | number | 50 | Max results (1–100) |
projectPath | string | cwd | Project root path |
kirograph_circular_deps
Find circular import dependencies using Tarjan's strongly connected components algorithm over import edges.
| Parameter | Type | Default | Description |
|---|---|---|---|
projectPath | string | cwd | Project root path |
kirograph_files
List the indexed file structure with filtering and format options.
| Parameter | Type | Default | Description |
|---|---|---|---|
filterPath | string | — | Filter by directory prefix (e.g., src/) |
pattern | string | — | Filter by glob pattern (e.g., **/*.ts) |
maxDepth | number | — | Limit tree depth |
format | string | tree | tree, flat, or grouped |
includeMetadata | boolean | true | Include language and symbol counts |
projectPath | string | cwd | Project root path |
kirograph_status
Check index health and statistics: files indexed, symbol count, edge count, breakdown by kind and language, frameworks detected, database size, semantic search status, and sync state.
| Parameter | Type | Default | Description |
|---|---|---|---|
projectPath | string | cwd | Project root path |
kirograph_architecture requires enableArchitecture
Get the full architecture overview: detected packages, layers, and the dependency graph between them.
| Parameter | Type | Default | Description |
|---|---|---|---|
projectPath | string | cwd | Project root path |
kirograph_coupling requires enableArchitecture
Get coupling metrics for all packages or a specific one: Ca (afferent), Ce (efferent), instability (Ce / (Ca + Ce)).
| Parameter | Type | Default | Description |
|---|---|---|---|
packageId | string | — | Package ID (e.g. pkg:npm:src/auth). Omit for all packages. |
projectPath | string | cwd | Project root path |
kirograph_package requires enableArchitecture
Inspect the files and dependencies of a specific package.
| Parameter | Type | Default | Description |
|---|---|---|---|
packageId | string | required | Package ID (e.g. pkg:npm:src/auth) |
projectPath | string | cwd | Project root path |
kirograph_hotspots
Find the most-connected symbols by total edge degree (incoming + outgoing). Excludes structural contains edges.
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | number | 20 | Max results (1–100) |
projectPath | string | cwd | Project root path |
kirograph_surprising
Find non-obvious cross-file connections scored by path distance × edge-kind weight. The most unexpected coupling in your codebase.
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | number | 20 | Max results (1–100) |
projectPath | string | cwd | Project root path |
kirograph_diff
Compare the current graph state against a saved snapshot. Shows added/removed symbols and edges.
| Parameter | Type | Default | Description |
|---|---|---|---|
snapshot | string | latest | Snapshot label. Omit to use the most recent saved snapshot. |
projectPath | string | cwd | Project root path |