SharpLens

Get detailed semantic information about a symbol at a specific position. IMPORTANT: Uses ZERO-BASED coordinates. If your editor shows 'Line 14, Column 5', pass line=13, column=4. Returns symbol kind, type, namespace, documentation, and location.

Get the inheritance hierarchy (base types and derived types) for a type. Returns baseTypes chain and derivedTypes list. IMPORTANT: Uses ZERO-BASED coordinates (editor line - 1).

Get all members (methods, properties, fields, events) of a type BY NAME. USAGE PATTERNS: - Basic: get_type_members("MyClass") - list all members - With inheritance: get_type_members("MyService", includeInherited=true) - Filter by kind: get_type_members("MyClass", memberKind="Method") - Verbosity control: verbosity="summary" (names only), "compact" (default, + signatures), "full" (+ docs, attrs) WORKS WITH: Fully-qualified ("MyNamespace.MyClass"), simple ("MyClass"), or partial names.

Get members for multiple types in a single call (batch optimization). USAGE: get_type_members_batch(typeNames: ['ServiceA', 'ServiceB', 'ControllerC']) OUTPUT: Results for each type with members, or error if type not found BENEFIT: One call instead of multiple - reduces context usage for AI agents

Get comprehensive type overview in ONE CALL: type info + base types (first 3) + member counts. USAGE: get_type_overview("MyService") - returns everything you need to understand a type quickly.

Fast navigation to symbol definition. Returns the definition location without finding all references. IMPORTANT: Uses ZERO-BASED coordinates (editor line 10 = pass line 9).

Check the health and status of the Roslyn MCP server and workspace. Returns: server status, solution loaded state, project count, and memory usage. Call this first to verify the server is ready.

Generate stub implementations for interface/abstract members. USAGE: Position cursor on class declaration that implements interface or extends abstract class. OUTPUT: Generated stub code for all missing members. IMPORTANT: Uses ZERO-BASED coordinates (editor line - 1).

Inline a variable, replacing all usages with its value. USAGE: Position cursor on a variable declaration or usage. OUTPUT: Variable removed and all usages replaced with the expression. IMPORTANT: Uses ZERO-BASED coordinates (editor line - 1).

Load a .NET solution for analysis. MUST be called before using any other analysis tools. Returns: projectCount, documentCount, and load time. Use health_check to verify current state.

Sort and remove unused using directives in a file. Returns the modified file content. Automatically removes unused usings and sorts alphabetically.

Organize using directives for multiple files in a project. Supports file pattern filtering (e.g., '*.cs', 'Services/*.cs'). PREVIEW mode by default - set preview=false to apply changes.

Safely rename a symbol (type, method, property, etc.) across the entire solution. Uses Roslyn's semantic analysis to ensure all references are updated. SUPPORTS PREVIEW MODE - always preview first! IMPORTANT: Uses ZERO-BASED coordinates. Default shows first 20 files with summary verbosity.

Search for types, methods, properties, etc. by name across the solution. Supports glob patterns (e.g., '*Handler' finds classes ending with 'Handler', 'Get*' finds symbols starting with 'Get'). Use ? for single character wildcard. PAGINATION: Returns totalCount and hasMore. Use offset to paginate through results.

Advanced semantic code query with multiple filters. Find symbols based on their semantic properties. EXAMPLES: - Async methods without CancellationToken: isAsync=true, parameterExcludes=["CancellationToken"] - Public static methods: accessibility="Public", isStatic=true - Classes with [Obsolete]: kinds=["Class"], attributes=["ObsoleteAttribute"] FILTERS: All specified filters are combined with AND logic. Omit a filter to skip it. Returns symbol details with locations.

Synchronize document changes from disk into the loaded solution. Call this after using Edit/Write tools to ensure Roslyn has fresh content. USAGE: - sync_documents(filePaths: ["src/Foo.cs", "src/Bar.cs"]) - sync specific files - sync_documents() - sync ALL documents (refresh entire solution) WHEN TO CALL: - After using Edit tool to modify .cs files - After using Write tool to create new .cs files - After deleting .cs files - NOT needed after using SharpLensMcp refactoring tools (they auto-update) HANDLES: Modified files (updates content), new files (adds to solution), deleted files (removes from solution). Much faster than load_solution - only updates documents, doesn't re-parse projects.

Check if code would compile without writing to disk. Use to validate generated code before applying. USAGE: validate_code(code="public void Foo() {}", contextFilePath="path/to/file.cs") to check with existing usings. OUTPUT: compiles (bool), errors list with line numbers. Essential before inserting AI-generated code.