Reference

ctx_multi_repo

Input contract and parameters for ctx_multi_repo.

Status by featureReviewed September 2026

MCP tool · Read, search & shell

Call this tool through your MCP client. Its availability depends on your active configuration and profile.

This registry contract is separate from the SDK. For terminal commands, use the CLI reference.

Parameters

Generated from the registered input schema. “Required” reflects the schema; individual actions can impose additional requirements.

actionstringRequired

Accepted: add_rootremove_rootlist_rootssearchstatussave_config

aliasstring

Short alias (auto-derived if omitted)

max_resultsinteger

Max results

modestring

Per-root ranking signal (default: hybrid; bm25 = lexical only)

Accepted: hybridbm25

pathstring

Repo path

querystring

Search query (for search action)

rootsarray

Filter to specific repos by alias/path

Exact JSON schema

Inspect the complete input schema

{
  "properties": {
    "action": {
      "description": "add_root|remove_root|list_roots|search|status|save_config",
      "enum": [
        "add_root",
        "remove_root",
        "list_roots",
        "search",
        "status",
        "save_config"
      ],
      "type": "string"
    },
    "alias": {
      "description": "Short alias (auto-derived if omitted)",
      "type": "string"
    },
    "max_results": {
      "description": "Max results",
      "type": "integer"
    },
    "mode": {
      "description": "Per-root ranking signal (default: hybrid; bm25 = lexical only)",
      "enum": [
        "hybrid",
        "bm25"
      ],
      "type": "string"
    },
    "path": {
      "description": "Repo path",
      "type": "string"
    },
    "query": {
      "description": "Search query (for search action)",
      "type": "string"
    },
    "roots": {
      "description": "Filter to specific repos by alias/path",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "action"
  ],
  "type": "object"
}

Runtime description

The following is the tool's own agent-facing description, reproduced from the reviewed registry. It can contain implementation terminology; it does not expand the public stability commitment.

Read the agent-facing description

Multi-repository — add, remove, search project directories.
WORKFLOW: list_roots → add_root/remove_root → search.
ANTI-PATTERN: not for single-repo projects — use ctx_search.
Actions: add_root|remove_root|list_roots|search|status|save_config.
Cross-repo search runs hybrid retrieval per root (BM25+dense+SPLADE)
and merges with RRF; mode="bm25" forces lexical-only.
ctx_search/ctx_glob/ctx_tree/ctx_read all accept a repo=<alias>
arg (not in their own schema) to target a registered root by
alias instead of the project root — list_roots shows the aliases.

Sources & versions3 references Reviewed 18 Sept 2026

mcp_manifest.rsrust/src/core/mcp_manifest.rsReviewed checkout
registry.rsrust/src/server/registry.rsReviewed checkout
dynamic_tools.rsrust/src/server/dynamic_tools.rsReviewed checkout

Core checkout: 50fbff09c9
Installed runtime: 3.10.2
SDK release: 1.1.0

Separate baselines for source, CLI/configuration and SDK contracts. Review does not certify every platform or integration.

Versions & compatibility