move_type

[refactoring]

Moves a type to another file or namespace and updates supported references.

Before you use this tool

Writes files by default. An authorized, unambiguous edit with a clear scope can apply directly. Set applyChanges: false for a preview without file writes. Preview when the user requests inspection only, the scope is unclear, or a broad refactor needs inspection. Types with multiple source declarations, enums, and delegates are unsupported. Ambiguous names return candidate keys without edits. Keys absent from the selected workspace fail.

Try it locally in the Glider playground

Parameters

Name	Type	Required	Description
symbolKey	string	No	Source class, struct, interface, or record key. Requires one source declaration. Do not combine with typeName or projectName.
typeName	string	No	Unique simple or fully qualified type name. Provide this or symbolKey.
targetFilePath	string	No	Optional target file path.
targetNamespace	string	No	Optional target namespace.
projectName	string	No	Optional project name to limit symbol search.
applyChanges	boolean	No	If true (default), applies changes to disk. If false, returns a preview diff. Default: `true`
formatAfter	boolean	No	Format changed documents after the move. Default is false. Default: `false`
organizeUsingsAfter	boolean	No	Organize usings in changed documents after the move. Default is false. Default: `false`
includeDiff	boolean	No	Include unified diff in response. Default is true. Default: `true`
maxDiffChars	number	No	Max diff characters. Use 0 for unlimited. Default is 50000. Default: `50000`
includePerFileDiff	boolean	No	Include diffs in changedFiles independently of includeDiff. File paths and counts remain available when false. Development builds after 13.4.0 default to false; released 13.4.0 defaults to true. Follow the installed schema. Default: `false`
pathStyle	string	No	Path style: 'absolute' (default) or 'relative' (to solution root). Default: `"absolute"`
responseDetail	string	No	compact returns results and actionable state. full adds diagnostic metadata under responseDiagnostics. Default: `"compact"`

Examples

Replace sample paths and symbol keys with values from your workspace.

Preview a type move to a new namespace

Arguments 
{
  "typeName": "MyClass",
  "targetNamespace": "MyApp.Utils",
  "applyChanges": false
}

Full MCP request

Full MCP request 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "move_type",
    "arguments": {
      "typeName": "MyClass",
      "targetNamespace": "MyApp.Utils",
      "applyChanges": false
    }
  }
}

Illustrative response 
{
  "success": true,
  "symbolName": "MyClass",
  "symbolKind": "Class",
  "sourceLocation": "/path/to/OldFile.cs",
  "targetLocation": "/path/to/NewFile.cs",
  "filesChanged": 3,
  "filesCreated": 1,
  "applied": false,
  "unifiedDiff": "...",
  "workspaceUpdate": null
}

Preview a discovered type move

Arguments 
{
  "symbolKey": "<type key from find_code>",
  "targetFilePath": "/path/to/NewFile.cs",
  "applyChanges": false
}

Full MCP request

Full MCP request 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "move_type",
    "arguments": {
      "symbolKey": "<type key from find_code>",
      "targetFilePath": "/path/to/NewFile.cs",
      "applyChanges": false
    }
  }
}

Response Notes

An applied refactor keeps the line endings each file already has. A file that mixes LF and CRLF is written with the ending it uses most. The unified diff normalizes both sides to LF, so it shows the edit and not the endings.

Returns a unified diff. Types with multiple source declarations, enums, and delegates are unsupported. Ambiguous names return candidates with symbolKey fields, without edits. Keys absent from the selected workspace fail. After apply, workspaceUpdate reports whether the new file belongs to a project. A reloaded_not_included result means no project compiles the new file.

Unreleased development builds after 13.4.0 return one unified diff by default; the example uses that contract. Follow the installed schema for supported parameters and defaults. Set includeDiff=false for compact output, with includePerFileDiff=false where supported. Set includePerFileDiff=true only when separate file diffs are needed; it works independently of includeDiff. These controls preserve application state, file metadata, counts, and any diagnostics, errors, conflicts, or limits the tool reports. Results use top-level fields with success. Compact is the default; full adds responseDiagnostics. Both modes retain errors, coverage, partial state, and recovery advice.

For a failed symbol-key request, success=false includes errorCode, parameter, error, and suggestions in compact, full, and batch operation results. Batch keeps a bounded summary outside the requested detail budget. If the hard server limit omits details, failureDetailsOmitted or writeStateOmitted identifies the omission. errorCode is invalid_symbol_key, symbol_not_found, ambiguous_symbol_key, wrong_symbol_kind, source_unavailable, unsupported_symbol, or invalid_arguments. Follow the suggestions for the specific failure. Correct the named selector for invalid_arguments. For symbol_not_found, repeat discovery in the selected workspace and pass a returned key unchanged. An absent identity does not prove that a key is stale.