MCP Tools Catalog

Below is the complete list of 19 MCP tools generated dynamically from the live tool definitions in the codebase at build time.

`get_skeleton`

Get compact minified project overview (10-50x smaller than source). Returns legend, stats, node summaries, file imports, and W web component summaries when present.

Input Parameters

Parameter	Type	Required	Description
`path`	`string`	Yes	Path to scan (e.g., "src/components")

`get_focus_zone`

Get enriched context for recently modified files. Auto-detects from git or accepts explicit file list.

Input Parameters

Parameter	Type	Required	Description
`path`	`string`	No
`useGitDiff`	`boolean`	No	Auto-detect from git diff
`recentFiles`	`array`	No	Explicit list of files to expand

`get_ai_context`

Boot AI agent context. Two modes: 1. Default: returns skeleton + docs (2-3k tokens) for structure overview. 2. includeFiles: ['*']: returns ALL compressed source code without skeleton/docs (pure code dump). Filters vendored files via .contextignore (auto-created on first call). Call FIRST when starting work. Use ['*'] for small/medium projects that fit in context.

Input Parameters

Parameter	Type	Required	Description
`path`	`string`	Yes	Project root path
`includeFiles`	`array`	No	Files to include. Use ["*"] for ALL source files (filtered by .contextignore). Or specific files: ["parser.js", "tools.js"]
`includeDocs`	`boolean`	No	Include doc-dialect documentation (default: true, auto-disabled with '*')
`includeSkeleton`	`boolean`	No	Include project skeleton (default: true, auto-disabled with '*')

`invalidate_cache`

Invalidate the cached graph. Use after making code changes.

Input Parameters

No parameters required.

`get_usage_guide`

Get the comprehensive usage guide for project-graph with examples and best practices. Call this FIRST when planning how to analyze, navigate, or audit a codebase. Returns practical examples and recommended workflow for each feature area. Available topics: navigation, analysis, testing, documentation, rules, workflow. Omit topic to get the full guide.

Input Parameters

Parameter	Type	Required	Description
`topic`	`string`	No	Optional topic filter: navigation, analysis, testing, documentation, rules, workflow

`get_agent_instructions`

Get coding guidelines, architectural standards, and JSDoc rules for this project.

Input Parameters

No parameters required.

`get_custom_rules`

List all custom code analysis rules. Rules are stored in JSON files in rules/ directory.

Input Parameters

No parameters required.

`set_custom_rule`

Add or update a custom code analysis rule. Creates ruleset if it does not exist.

Input Parameters

Parameter	Type	Required	Description
`ruleSet`	`string`	Yes	Name of ruleset (e.g., "symbiote", "react", "custom")
`rule`	`object`	Yes	Rule definition with id, name, description, pattern, patternType, replacement, severity, filePattern

`check_custom_rules`

Run custom rules analysis on a directory. Returns violations found.

Input Parameters

Parameter	Type	Required	Description
`path`	`string`	Yes	Path to scan
`ruleSet`	`string`	No	Optional: specific ruleset to use
`severity`	`string`	No	Optional: filter by severity (error/warning/info)

`get_framework_reference`

Get framework-specific AI reference documentation. Auto-detects framework from project or accepts explicit name. Returns full API reference, patterns, and common mistakes as agent context.

Input Parameters

Parameter	Type	Required	Description
`framework`	`string`	No	Framework reference name (e.g., "symbiote-3x"). If omitted, auto-detects from path.
`path`	`string`	No	Project path for auto-detection (e.g., "src/")

`graph_metadata`

Read and validate project-local graph metadata sidecar. Actions: get|validate

Input Parameters

Parameter	Type	Required	Description
`action`	`string`	Yes	Metadata action to perform
`path`	`string`	Yes	Project root path
`metadata`	`object`	No	For validate: metadata object to validate instead of reading the sidecar

`navigate`

Navigate the project graph. Actions: expand|deps|usages|call_chain|sub_projects. deps returns code calls plus web template/style/component links when present.

Input Parameters

Parameter	Type	Required	Description
`action`	`string`	Yes	Navigation action to perform
`symbol`	`string`	No	Symbol name (for expand, deps, usages)
`from`	`string`	No	Starting symbol (for call_chain)
`to`	`string`	No	Target symbol (for call_chain)
`path`	`string`	No	Path to scan (for call_chain, sub_projects)

`analyze`

Input Parameters

Parameter	Type	Required	Description
`action`	`string`	Yes	Analysis type to run
`path`	`string`	Yes	Path to scan
`minComplexity`	`number`	No	For complexity: minimum threshold (default: 1)
`onlyProblematic`	`boolean`	No	For complexity/large_files: only show issues
`threshold`	`number`	No	For similar_functions: min similarity % (default: 60)
`includeItems`	`boolean`	No	For full_analysis: include individual items
`level`	`string`	No	For undocumented: strictness level
`codeOnly`	`boolean`	No	For outdated_patterns: only check code
`depsOnly`	`boolean`	No	For outdated_patterns: only check deps

`testing`

Test checklist management. Actions: pending|pass|fail|summary|reset

Input Parameters

Parameter	Type	Required	Description
`action`	`string`	Yes	Test action to perform
`path`	`string`	No	Path to scan (for pending, summary)
`testId`	`string`	No	Test ID (for pass, fail)
`reason`	`string`	No	Failure reason (for fail)

`filters`

Filter configuration. Actions: get|set|add_excludes|remove_excludes|reset

Input Parameters

Parameter	Type	Required	Description
`action`	`string`	Yes	Filter action to perform
`excludeDirs`	`array`	No	For set: directories to exclude
`excludePatterns`	`array`	No	For set: file patterns to exclude
`useGitignore`	`boolean`	No	For set: use .gitignore patterns
`includeHidden`	`boolean`	No	For set: include hidden directories
`dirs`	`array`	No	For add_excludes/remove_excludes

`jsdoc`

JSDoc operations. Actions: check_consistency|check_types|generate

Input Parameters

Parameter	Type	Required	Description
`action`	`string`	Yes	JSDoc action to perform
`path`	`string`	Yes	Path to scan
`name`	`string`	No	For generate: specific function name
`files`	`array`	No	For check_types: specific files
`maxDiagnostics`	`number`	No	For check_types: max diagnostics (default: 50)

`docs`

Documentation (.ctx) management. Actions: get|generate|check_stale|validate_contracts

Input Parameters

Parameter	Type	Required	Description
`action`	`string`	Yes	Documentation action to perform
`path`	`string`	Yes	Project root path
`file`	`string`	No	For get: specific file docs
`overwrite`	`boolean`	No	For generate: overwrite existing (merge preserves descriptions)
`scope`	`any`	No	For generate: "all", "focus" (git diff), or array of file paths
`strict`	`boolean`	No	For validate_contracts: report functions missing from .ctx

`compact`

Input Parameters

Parameter	Type	Required	Description
`action`	`string`	Yes	Compact action to perform
`path`	`string`	No	Path to file or directory
`symbol`	`string`	No	For edit: function/class name to replace
`code`	`string`	No	For edit: new code for the symbol
`beautify`	`boolean`	No	Beautify output (default: true)
`legend`	`boolean`	No	For compact_file: include export legend
`dryRun`	`boolean`	No	Preview without modifying
`mode`	`number`	No	For set_mode: 1 (compact, recommended) or 2 (full)
`autoValidate`	`boolean`	No	For set_mode: auto-validate after edits
`stripJSDoc`	`boolean`	No	For set_mode: strip JSDoc when compacting
`strict`	`boolean`	No	For validate_pipeline: report fns missing from .ctx
`fix`	`boolean`	No	For validate_pipeline: auto-fix all style issues — generates .ctx documentation from readable code, then minifies (headers, imports, indentation, long names). Bidirectional: expand restores from .ctx.

`db`

Database analysis. Actions: schema|table_usage|dead_tables

Input Parameters

Parameter	Type	Required	Description
`action`	`string`	Yes	Database analysis action
`path`	`string`	Yes	Path to scan
`table`	`string`	No	For table_usage: filter to specific table