Reference

ctx_knowledge

Input contract and parameters for ctx_knowledge.

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.

Example call

JSON for an MCP client. Replace example paths and queries with your own project values.

{
  "name": "ctx_knowledge",
  "arguments": {
    "action": "recall",
    "query": "authentication"
  }
}

Parameters

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

actionstringRequired

as_ofstring

YYYY-MM-DD date filter

categorystring

Fact category

confidencenumber

0.0-1.0

contentstring

Alias for value (remember)

dry_runboolean

consolidate: preview imports/reclaim without writing

examplesarray

formatstring

export: json|okf (okf = portable Markdown bundle)

keystring

limitnumber

restore: max items to recover (default 50)

mergestring

import: replace|append|skip-existing (default skip-existing)

modestring

auto|exact|semantic|hybrid

pathstring

export/import: bundle directory (OKF) or file path

pattern_typestring

querystring

Query for recall/search/relate/restore

resolutionstring

gotcha resolution/fix

severitystring

gotcha: critical|warning|info

storestring

restore: facts|history|procedures|patterns (default: all)

triggerstring

gotcha trigger pattern

valuestring

Exact JSON schema

Inspect the complete input schema

{
  "properties": {
    "action": {
      "description": "remember|recall|search|pattern|gotcha|relate|relations|consolidate|restore|status|timeline|rooms|wakeup|remove|export|import (also: feedback, unrelate, relations_diagram, health, lifecycle_report, policy, embeddings_*)",
      "type": "string"
    },
    "as_of": {
      "description": "YYYY-MM-DD date filter",
      "type": "string"
    },
    "category": {
      "description": "Fact category",
      "type": "string"
    },
    "confidence": {
      "description": "0.0-1.0",
      "type": "number"
    },
    "content": {
      "description": "Alias for value (remember)",
      "type": "string"
    },
    "dry_run": {
      "description": "consolidate: preview imports/reclaim without writing",
      "type": "boolean"
    },
    "examples": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "format": {
      "description": "export: json|okf (okf = portable Markdown bundle)",
      "type": "string"
    },
    "key": {
      "type": "string"
    },
    "limit": {
      "description": "restore: max items to recover (default 50)",
      "type": "number"
    },
    "merge": {
      "description": "import: replace|append|skip-existing (default skip-existing)",
      "type": "string"
    },
    "mode": {
      "description": "auto|exact|semantic|hybrid",
      "type": "string"
    },
    "path": {
      "description": "export/import: bundle directory (OKF) or file path",
      "type": "string"
    },
    "pattern_type": {
      "type": "string"
    },
    "query": {
      "description": "Query for recall/search/relate/restore",
      "type": "string"
    },
    "resolution": {
      "description": "gotcha resolution/fix",
      "type": "string"
    },
    "severity": {
      "description": "gotcha: critical|warning|info",
      "type": "string"
    },
    "store": {
      "description": "restore: facts|history|procedures|patterns (default: all)",
      "type": "string"
    },
    "trigger": {
      "description": "gotcha trigger pattern",
      "type": "string"
    },
    "value": {
      "type": "string"
    }
  },
  "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

Persistent memory across sessions — remember decisions, patterns, and facts for recall.
WORKFLOW: save after completing significant tasks; recall at session start.
action=remember value='Y' saves a fact (key optional — derived from value; content= is an accepted alias).
action=recall query='X' retrieves it (bare recall lists recent facts). action=status shows all categories.
action=consolidate imports latest session if present, runs lifecycle, then frees 25% facts/history/procedures capacity.
action=gotcha trigger='X' resolution='Y' for known pitfalls.
mode=semantic|exact for recall. category groups related facts.

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