io.github.jcucci/dotnet-sherlock-mcp

Lists all public types in an assembly with metadata summary. Returns totalTypeCount for pagination planning. Use maxItems=25 for large assemblies (100+ types). Follow with get_type_info for specific types.

Gets detailed info about a specific method including all overloads, parameters, attributes, and return types. Use after finding the method via get_type_members or search_members. Lightweight response.

Evaluates a project file (.csproj/.vbproj/.fsproj) with the installed .NET SDK's MSBuild, honouring Directory.Build.props, central package management and conditions, and returns target frameworks, package refs, project refs and output paths. Falls back to XML parsing when no SDK is available; evaluation.mode says which was used. Use get_project_output_paths to find compiled assemblies.

Parses a .sln file and lists all contained projects with paths. Use as entry point to discover project structure before analyze_project. Lightweight response.

Deprecated: use get_type_info for type metadata plus get_type_members with projection='full' for members. Gets type metadata with paginated members (constructors, methods, properties, fields). Returns member totals for pagination planning. Use include* flags to filter member categories.

Diffs the public API of two versions of an assembly (left = old, right = new) and flags breaking changes: removed types/members, changed return/parameter types, reduced accessibility, sealed/abstract/static changes, removed base types or interfaces, abstract members added to interfaces or inheritable classes, and more. Each side is an assembly path, an asm_ handle from open_assembly, or a NuGet package as 'Package.Id@1.2.3' resolved from the local NuGet cache (omit the version for the highest cached one). Returns counts plus the breaking changes by default; projection='full' lists every added/removed/changed type and member with left/right signatures and reasons. Use when upgrading a package or reviewing a release for compatibility.

Decompiles a single member (method, property, field, event or constructor) to C# source, showing its body - what signature-level tools can't. Returns every overload of the name unless parameterTypes narrows it. Source is paged by line: follow continuationToken while truncated is true. Prefer this over decompile_type.

Decompiles a whole type to C# source. Output can be large, so it is paged by line: follow continuationToken while truncated is true. Prefer decompile_member when you only need one member's body.

Recursively searches workingDirectory for .dll/.exe files that declare a public type matching className, skipping obj/, ref/, refint/, node_modules/, packages/, TestResults/ and dot-directories. Matches are ranked bin/ first, then newest, then shortest path; returns the best match as foundAssembly plus other candidates. Use when you know the class but not the assembly path.

Recursively searches workingDirectory for an assembly file name, skipping obj/, ref/, refint/, node_modules/, packages/, TestResults/ and dot-directories. Matches are ranked bin/ first, then newest, then shortest path; returns the best match as foundAssembly plus other candidates. Use when you know the assembly name but not its full path.

Finds an assembly in the local NuGet cache by package id. Probes ~/.nuget/packages (or NUGET_PACKAGES env var). Use when you know the package id/version but not the DLL path. Picks the highest version when omitted. When tfm is omitted and the package ships several, clients that support elicitation are asked which one to use; otherwise the best TFM is picked. The response lists availableVersions and availableTfms.

Parses deps.json from build output to list all runtime dependencies including transitive refs. Useful for understanding full dependency graph.

Finds Entity Framework Core entities: the DbSet<T> properties (declared or inherited) of every DbContext subclass across one or more assemblies. Entities configured only in OnModelCreating are not listed. Returns a lean summary ({ context, property, entity }) by default; projection='full' adds assemblyPath.

Finds ASP.NET Core HTTP endpoints across one or more assemblies: MVC/API controller actions (attribute routes combined from [Route]/[Http*] with [controller]/[action] substituted) and minimal APIs (Map{Get,Post,Put,Delete,Patch,Methods,Group,Fallback} calls read from IL). Minimal-API routes and handlers come from string literals and method references next to the call, so routes held in variables or fields are reported as null. Returns a lean summary ({ kind, httpMethods, route, handler }) by default; projection='full' adds assemblyPath, handlerType, handlerMethod and registeredIn.

Finds extension methods that extend the given type, across one or more assemblies. Scans static classes for methods whose first ('this') parameter matches the target type. Returns a lean summary ({ declaringType, methodName, signature }) by default. Pass projection='full' for assemblyPath and extendedType. Open-generic match supported (e.g., 'IEnumerable<>' matches extensions on 'IEnumerable<T>').

Finds MediatR-style handlers across one or more assemblies: concrete types implementing IRequestHandler<,>/IRequestHandler<>, INotificationHandler<>, IStreamRequestHandler<,> or IPipelineBehavior<,> from the MediatR or Mediator namespaces. Returns a lean summary ({ kind, handler, message, response }) by default; projection='full' adds assemblyPath and interface.

Finds types that implement an interface or derive from a base type, across one or more assemblies. Returns a lean summary ({ typeFullName, kind }) by default. Pass projection='full' for matchedInterfaces[] and baseTypeChain[]. Matches by simple name, full name, or open-generic form (e.g., 'IEnumerable', 'IEnumerable<T>', 'IEnumerable<>', 'IEnumerable`1').

Finds methods whose return type matches the given type, across one or more assemblies. Returns a lean summary ({ declaringType, methodName, signature }) by default. Pass projection='full' for assemblyPath, returnType, isStatic. Open-generic match supported (e.g., 'Snapshot<>' matches methods returning 'Snapshot<int>').

Finds all references to a type across one or more assemblies: base types, implemented interfaces, method returns/parameters, field/property/event types (recurses into generic arguments). With analysisDepth='il', also scans method bodies for inbound callers ('who calls into this type?'). Bounded sweep with hardCap to protect against runaway scans; check truncated=true. Returns lean summary by default; projection='full' adds assemblyPath, signature, dedupeKey.

Finds Microsoft.Extensions.DependencyInjection registrations by reading IL for calls to Add{Singleton,Scoped,Transient}, TryAdd*, AddKeyed*, AddHostedService and ServiceDescriptor factories, across one or more assemblies. Service/implementation types come from generic arguments or typeof(...) operands; factory and instance registrations report implementation=null. Every method body is scanned (registrations usually live in non-public Program code). Returns a lean summary ({ lifetime, service, implementation, registeredIn }) by default; projection='full' adds assemblyPath, registrationMethod, registrationKind, isTryAdd and isKeyed.

Deprecated: use get_type_members with projection='full' (filter with kinds / nameContains). Gets ALL members (methods, properties, fields, events, constructors) in one call. WARNING: Can produce very large responses for complex types.

Gets assembly-level metadata: identity/version, target framework, and referenced assemblies. Lightweight orientation tool — call before deep type analysis. Use projection='full' for all assembly-level attributes structurally.

Gets generic type parameters, constraints, and variance for generic types. Only useful for types where IsGenericType=true. Lightweight response.

Gets custom attributes for a specific member (method, property, field, event, constructor). Returns attribute types and values. Use after identifying the member via get_type_members or search_members.

Returns a member's original source code (with comments and real names) from the assembly's portable PDB: source embedded in the PDB, the local file it was built from, or the Source Link URL (fetched from known source hosts only). Falls back to decompiled C# per overload when no source is available; origin says which (sourcelink, embedded, local, decompiled, or mixed) and note says why a fallback happened. Returns every overload unless parameterTypes narrows it. Paged by line: follow continuationToken while truncated is true. Prefer this over decompile_member.

Analyzes a method's IL body to list what it calls and which fields it touches (the 'what does this method call?' question that signature-level tools can't answer). Aggregates across all overloads of the method name. Returns a lean summary by default (distinct target names); projection='full' adds per-call kind (call/callvirt/newobj/ldftn) and the source overload signature. format='mermaid' returns a Mermaid flowchart call graph instead, following same-assembly callees transitively up to depth levels (external calls are leaves).

Gets nested/inner types declared within a type. Use for types with inner classes, structs, or enums. Lightweight response.

Reads the restored NuGet graph from obj/project.assets.json: the exact package versions the project compiles against (direct and transitive), for one target framework and optional runtime identifier. Pass projectPath (a project file, its directory, or the assets file) or an assemblyPath/assemblyHandle from the project's bin output. Summary lists { id, version, type, direct, dependencyCount }; projection='full' adds each package's dependency ranges and resolved compile assemblies. Run 'dotnet restore' first if the assets file is missing; resolve_package_references only probes the NuGet cache for declared versions.

Gets custom attributes for a specific parameter of a method or constructor. Use when you need to inspect parameter-level attributes like [FromBody], [Required], etc.

Gets compiled assembly output directories for a project by configuration and target framework, evaluated with MSBuild (custom OutputPath, artifacts layout, Directory.Build.props) or parsed from XML when no SDK is available. Use to find DLL paths for assembly analysis tools. Lightweight response.

Gets current runtime configuration (default page sizes, cache TTL, search roots). Use to understand current settings before update_runtime_options.

Gets custom attributes declared on a type (e.g., [Serializable], [Obsolete]). Returns attribute types and values. Lightweight response.

Deprecated: use get_type_members with kinds=constructor. Gets constructors from a type with filtering and pagination. Returns parameter info and access modifiers. Most types have few constructors - use maxItems=30.

Deprecated: use get_type_members with kinds=event. Gets events from a type with filtering and pagination. Returns event handler types and add/remove accessor info. Most types have few events.

Deprecated: use get_type_members with kinds=field. Gets fields from a type with filtering and pagination. Returns const/readonly/volatile info and constant values. Fields are compact - can use larger maxItems (75+).

Gets full inheritance chain and implemented interfaces for a type. Use to understand type relationships and find inherited members. Lightweight response. By default derivedTypes is null with a note - pass additionalAssemblies to compute derived/implementing types via the same scan as find_implementations_of. format='mermaid' returns a Mermaid classDiagram instead of JSON fields.

Gets detailed metadata for a single type including accessibility, inheritance, interfaces, and member counts. Lightweight response - use as entry point before exploring members with get_type_members.

Lists the members of a type - methods, properties, fields, events and constructors - with filtering and pagination. Narrow with kinds (csv: method|property|field|event|constructor), nameContains and hasAttributeContains. Returns a lean summary ({ kind, name, signature }) by default; the C# signature already carries types, parameters and modifiers. Pass projection='full' for structured parameters[], attributes and modifier flags per kind (replaces get_all_type_members / analyze_type). Members are grouped by kind (constructors, properties, fields, events, methods) and sorted within each kind. Use get_type_info for type-level metadata and analyze_method for one method's overloads.

Deprecated: use get_type_members with kinds=method. Gets methods from a type with filtering and pagination. Returns a lean summary ({ name, signature }) by default - the signature already encodes return type, parameters, and modifiers in C# form. Pass projection='full' when you need structured fields (parameters[], attributes, returnType, isStatic/Virtual/Abstract/..., genericTypeParameters); prefer analyze_method for one method. Large types may have 100+ methods - use nameContains filter or maxItems=25 for efficiency.

Deprecated: use get_type_members with kinds=property. Gets properties from a type with filtering and pagination. Returns getter/setter info, indexers, and access modifiers.