load

[solution]

Loads repositories and returns their index status. Unreleased: manage several roots in one process.

Parameters

Name	Type	Required	Description
responseDetail	string	No	compact returns results and actionable state. full returns the original envelope with timing, revision, and display annotations. Default: `"compact"`
root	string	Required if roots is omitted	Absolute path to the workspace root to index.
roots	json	No	Root objects with an absolute root and optional semantic: true, false, or null. Use root or roots. The process supports 16 roots. Unreleased
mode	string	No	replace (default) replaces the loaded set. add adds roots or updates named roots. Unnamed roots retain their settings. Unreleased
acknowledge	boolean	No	Allow a root outside the server's home family (a widened sandbox). Default false. Default: `false`
semantic	boolean	No	Enable or disable semantic search with the legacy root form. Use each root object's semantic field with roots. Omission follows startup flags, root configuration, then the disabled default. In add mode, omission retains an existing runtime override. A root object's null clears that override.

Examples

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

Point the server at a git worktree

Arguments 
{
  "root": "/repo/.claude/worktrees/feature"
}

Full MCP request

Full MCP request 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "load",
    "arguments": {
      "root": "/repo/.claude/worktrees/feature"
    }
  }
}

Response Notes

Loads a root without a restart. A root outside the startup families requires acknowledge: true. Returns index and tier status.

Unreleased multi-root support: use root or roots. replace replaces the set; add updates named roots and retains unnamed roots. Each named root rereads its configuration. Runtime semantic overrides precede startup flags, root configuration, and the disabled default. In add mode omission retains an override; false disables it and null clears it. Startup --semantic applies to every root, so omit it for mixed configuration. The response includes transition IDs for added, updated, unchanged, and removed roots. No-op additions retain pagination identities. Failed preflight retains the set and process policy. If a same-store reconfiguration stops the previous semantic tier before failure, retry the load. Startup families remain fixed; an outside root requires acknowledge on every load.