Skip to content

Tool reference

This reference is generated from the production Host composition for 0.1.0-beta.294. The catalog is the compact machine-readable index; each tool page links to its complete MCP definition.

Code Actions

Tool Operation Area Purpose
list-code-actions Query CodeAction Lists bounded Roslyn code fixes and refactorings for a document, selection or caret.
prepare-fix-all Query CodeAction Revalidates a Code Fix and reports the bounded impact of one explicit Fix All scope without staging changes.
stage-code-action Mutation CodeAction Revalidates and stages one selected Code Fix, refactoring or prepared Fix All action into the active transaction.

Code analysis

Tool Operation Area Purpose
analyze-async Query CorePlugin Returns bundled AsyncFixer diagnostics and compiler diagnostic CS4014 for a selected scope.
analyze-control-flow Query CorePlugin Analyzes control flow for an exact complete statement or contiguous statement range.
analyze-data-flow Query CorePlugin Analyzes data flow for an exact expression, complete statement, or contiguous statement range.
analyze-disposables Query CorePlugin Returns advisory findings for undisposed local disposable values.
analyze-nullability Query CorePlugin Returns nullable-flow diagnostics for a selected scope or location.
find-dependency-cycles Query CorePlugin Returns detected dependency cycles for the selected scope and granularity.
find-duplicate-code Query CorePlugin Returns bounded duplicate executable-block pointers that normalize to the same statement sequence.
find-unused-symbols Query CorePlugin Returns candidate unused locals and members from compiler diagnostics.
get-change-impact Query CorePlugin Returns a bounded impact summary and supporting source locations for a symbol change.
get-control-flow-graph Query CorePlugin Returns a bounded control-flow graph with operation metadata and exact source pointers.
get-dependency-graph Query CorePlugin Returns a bounded dependency graph for the selected scope and granularity.
get-diagnostics Query CorePlugin Returns compiler and analyzer diagnostics for a selected scope.
get-document-options Query CorePlugin Returns language and optional detailed parse and analyzer-config options for a document.
get-operation-tree Query CorePlugin Returns a bounded IOperation tree with metadata and exact source pointers.
get-symbol-dependencies Query CorePlugin Returns the direct symbols used by a resolved symbol.
get-symbol-dependents Query CorePlugin Returns symbols that directly depend on a resolved symbol.
get-test-impact Query CorePlugin Returns likely impacted tests for a resolved symbol.

Code discovery and navigation

Tool Operation Area Purpose
find-callees Query CorePlugin Returns symbols directly invoked by a method or selected executable body.
find-callers Query CorePlugin Returns bounded direct source call sites and containing symbols.
find-derived-types Query CorePlugin Finds derived types for a resolved base type.
find-implementations Query CorePlugin Finds implementations of an interface or abstract member.
find-overloads Query CorePlugin Returns overload signatures for a resolved method or constructor.
find-overrides Query CorePlugin Finds overrides of a virtual or abstract member.
find-references Query CorePlugin Finds source references, optionally including declarations and access classification.
get-api-surface Query CorePlugin Returns exported API symbols for a selected scope.
get-code-context Query CorePlugin Returns a bounded code window with the enclosing semantic context for a selected location.
get-document-outline Query CorePlugin Returns a bounded semantic outline for one document.
get-partial-declarations Query CorePlugin Returns the declarations for a partial type or method.
get-project-details Query CorePlugin Returns project metadata, options and selected document details.
get-solution-structure Query CorePlugin Returns bounded solution folders, projects, target frameworks and direct project relationships.
get-symbol-attributes Query CorePlugin Returns declared and inherited attributes for a resolved symbol.
get-symbol-info Query CorePlugin Returns detailed metadata for a resolved symbol.
get-symbol-members Query CorePlugin Lists declared members and optional inherited or interface members for a resolved symbol.
get-type-hierarchy Query CorePlugin Returns base, interface, and optional derived type relationships for a resolved type.
go-to-definition Query CorePlugin Finds source or metadata definitions for a resolved symbol.
resolve-symbol Query CorePlugin Resolves the symbol at a location or selection and returns its canonical selector.
search-symbols Query CorePlugin Searches declarations by name, metadata name and optional semantic filters.

Code mutation

Tool Operation Area Purpose
format-document Mutation CorePlugin Stages Roslyn formatting for one document or one selected range.
rename-symbol Mutation CorePlugin Stages a symbol rename across the effective solution.

Error reporting

Tool Operation Area Purpose
get-error-details Query Server Returns temporary local diagnostic details for an unexpected tool failure. The result may contain paths and user-authored identifiers, is intended only for the trusted local agent, and must never be submitted externally.
prepare-error-report Query Server Creates the complete external payload without network activity. Exception messages may contain Workspace data. Present the returned destination, payload JSON string and digest to the user before calling submit-error-report when approval is required; the user can choose to remove exception messages during submission.
submit-error-report Mutation Server After applying the configured consent policy, submits one previously prepared immutable external error report to its reviewed destination.

Server lifecycle

Tool Operation Area Purpose
server-status Query Server Returns server diagnostics without requiring a loaded workspace.

Transactions

Tool Operation Area Purpose
transaction-commit Mutation Server Commits the current staged transaction to disk.
transaction-history Mutation Server Moves backward or forward through staged transaction history.
transaction-preview Query Server Previews the current staged transaction.
transaction-rollback Mutation Server Rolls back the current staged transaction.
transaction-start Mutation Server Starts a new staged transaction. Check workspace-status first and do not mutate a workspace that is or may be in use elsewhere unless mutation ownership has been coordinated.

Workspaces

Tool Operation Area Purpose
workspace-close Mutation Server Closes the selected workspace.
workspace-list Query Server Lists the currently loaded workspaces.
workspace-open Mutation Server Loads an additional writable workspace. Open only a fully trusted workspace: loading evaluates MSBuild project logic, evaluated source inputs including external linked or package-provided documents become queryable, and later diagnostic or Code Action operations can load and execute project analyzers with the Host's permissions. Documents outside workspaceRoot remain read-only. If instance status reports that the workspace is or may be in use elsewhere, use it only for necessary queries, expect results to become stale, and coordinate mutation ownership before starting a transaction.
workspace-reload Mutation Server Reloads the selected workspace when it is out of date.
workspace-status Query Server Reports the selected workspace lifecycle and cross-instance state. Treat a workspace that is or may be in use elsewhere as query-only, use it only when necessary, and expect results to become stale.