Tools

Tools Overview

Complete reference for all 12 MCP tools in Stellarion

Stellarion provides 12 specialized MCP (Model Context Protocol) tools that extend Claude Code with powerful code analysis capabilities. These tools are automatically available when you install Stellarion and work seamlessly with Claude Code's natural language interface.

How Tools Work

When you ask Claude Code a question about your code, Stellarion's tools are invoked automatically based on your request. You can also invoke tools directly using the MCP function call syntax:

mcp__stellarion__<tool_name> parameter:value parameter:value

For example:

mcp__stellarion__analyze_quality type:complexity path:src/ threshold:15

Tool Categories

Search Tools

Tools for finding code in your codebase using different search strategies.

ToolPurposeExample Command
search_semanticAI-powered natural language searchmcp__stellarion__search_semantic query:"error handling logic"
search_patternRegex-based pattern matchingmcp__stellarion__search_pattern pattern:"TODO|FIXME" path:src/
get_code_elementExtract specific functions or classesmcp__stellarion__get_code_element name:UserService type:class

Analysis Tools

Tools for understanding code structure, quality, and dependencies.

ToolPurposeExample Command
analyze_structureDependency and coupling analysismcp__stellarion__analyze_structure type:dependencies path:src/index.ts
analyze_qualityComplexity and code health metricsmcp__stellarion__analyze_quality type:complexity threshold:15
analyze_impactChange risk assessmentmcp__stellarion__analyze_impact path:src/core/engine.ts

Project Tools

Tools for managing and understanding your project as a whole.

ToolPurposeExample Command
index_projectIndex codebase for semantic searchmcp__stellarion__index_project forceReindex:true
project_infoProject metadata and structuremcp__stellarion__project_info includeLanguages:true

Reporting Tools

Tools for generating comprehensive reports and finding improvement opportunities.

ToolPurposeExample Command
generate_reportQuality and architecture reportsmcp__stellarion__generate_report reportType:quality outputFormat:markdown
find_refactoringIdentify refactoring opportunitiesmcp__stellarion__find_refactoring focus:complexity includePriority:true

Utility Tools

Specialized tools for specific use cases.

ToolPurposeExample Command
extract_endpointsExtract REST API endpointsmcp__stellarion__extract_endpoints framework:express outputFormat:openapi
batch_analyzeBulk file analysismcp__stellarion__batch_analyze pattern:"src/**/*.ts" operations:["complexity","quality"]

Natural Language vs Direct Invocation

Simply describe what you want in plain English. Claude Code will select the appropriate tool automatically:

"Find all error handling code in this project"
→ Stellarion uses search_semantic

"What's the complexity of my codebase?"
→ Stellarion uses analyze_quality

"Which files would be affected if I change auth.ts?"
→ Stellarion uses analyze_impact

"Find functions with more than 5 parameters"
→ Stellarion uses find_refactoring with focus:interfaces

Direct Tool Invocation

When you need precise control over tool parameters:

Use mcp__stellarion__analyze_quality with type:complexity, path:src/services/, threshold:20, groupBySeverity:true
Run mcp__stellarion__find_refactoring with focus:duplication, includeEffort:true, outputFormat:markdown

Tool Chaining

Tools work together for comprehensive analysis. For example, a complete code quality assessment might use:

  1. project_info - Understand the project structure
  2. index_project - Enable semantic search
  3. analyze_quality - Measure complexity and find issues
  4. find_refactoring - Identify improvement opportunities
  5. generate_report - Create documentation of findings

Parameter Format

When invoking tools directly, use this format:

  • Strings: parameter:value or parameter:"value with spaces"
  • Numbers: parameter:15
  • Booleans: parameter:true or parameter:false
  • Arrays: parameter:["item1","item2"]

Next Steps

Explore individual tool documentation for detailed parameters, examples, and use cases.