Reference

ctx_artifacts

Input contract and parameters for ctx_artifacts.

Status by featureReviewed September 2026

MCP tool · Knowledge tools

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: liststatusindexreindexsearchremove

formatstring

json|markdown

Accepted: jsonmarkdown

namestring

Artifact name

project_rootstring

Project root

querystring

Search query

top_kinteger

Max results (default depends on action, capped at 1000)

Exact JSON schema

Inspect the complete input schema

{
  "properties": {
    "action": {
      "description": "list|status|index|reindex|search|remove",
      "enum": [
        "list",
        "status",
        "index",
        "reindex",
        "search",
        "remove"
      ],
      "type": "string"
    },
    "format": {
      "description": "json|markdown",
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "name": {
      "description": "Artifact name",
      "type": "string"
    },
    "project_root": {
      "description": "Project root",
      "type": "string"
    },
    "query": {
      "description": "Search query",
      "type": "string"
    },
    "top_k": {
      "description": "Max results (default depends on action, capped at 1000)",
      "type": "integer"
    }
  },
  "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

Context artifact registry with BM25 search — manage and query indexed code artifacts.
WORKFLOW: index artifacts first (index/reindex), then search with query for semantic retrieval.
Actions: list|status|index|reindex|search|remove.
ANTIPATTERN: NOT for general code search — use ctx_semantic_search for codebase queries.

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