Tool Reference
Tech Debt MCP exposes 16 tools. All tool schemas are generated from TOOL_DEFINITIONS in src/server/tools.ts at build time — what you see here matches what the server advertises.
| Tool | Kind | Description |
|---|---|---|
analyze_project | read-only | Analyze an entire project for technical debt. Scans all supported files and returns a comprehensive report with issues, metrics, and recommendations. |
analyze_file | read-only | Analyze a single file for technical debt issues. |
get_debt_summary | read-only | Get a quick summary of technical debt in a project. |
get_sqale_metrics | read-only | Get SQALE technical debt metrics including remediation time, debt ratio, and rating. |
list_supported_languages | read-only | List all programming languages supported by the analyzer. |
get_recommendations | read-only | Get prioritized recommendations for addressing technical debt. |
get_issues_by_severity | read-only | Get all issues of a specific severity level. |
get_issues_by_category | read-only | Get all issues of a specific category. |
add_custom_rule | destructive | Add a custom pattern-based tech debt rule. |
remove_custom_rule | destructive | Remove a custom rule by ID. |
list_custom_rules | read-only | List all active custom rules with their statistics. |
execute_custom_rules | read-only | Execute all custom rules against code or a file. |
validate_custom_pattern | read-only | Validate a custom pattern before adding it as a rule. |
check_dependencies | read-only | Analyze project dependencies across multiple package managers. |
validate_config | read-only | Validate a .techdebtrc.json configuration file for syntax and schema correctness. |
get_vulnerability_report | read-only | Generate an offline dependency report listing all project dependencies for vulnerability review. Note: actual CVE lookups require Phase 2b online integration. |
Resources
Beyond tools, the server registers two RFC-6570 resource templates:
debt://summary/{+projectPath}— quick debt summary for a project root.debt://issues/{+projectPath}— full issue list for a project root.
The leading / of an absolute path doubles the slash after debt://summary — e.g. debt://summary//Users/me/repo.