Skip to content
Documentation

Reference

ctx_ledger

Input contract and parameters for ctx_ledger.

Status by featureReviewed September 2026

MCP tool · Session state

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_ledger",
  "arguments": {
    "action": "status"
  }
}

Parameters

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

actionstringRequired

status|reset|evict

Accepted: statusresetevict

targetsstring

Paths to evict (comma-separated)

Exact JSON schema

Inspect the complete input schema
{
  "properties": {
    "action": {
      "description": "status|reset|evict",
      "enum": [
        "status",
        "reset",
        "evict"
      ],
      "type": "string"
    },
    "targets": {
      "description": "Paths to evict (comma-separated)",
      "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
Context ledger — track persistent context pressure.
WORKFLOW: status → evict → reset (reset only if budget needs full flush).
ANTI-PATTERN: don't evict files you actively need — check status first.
Actions: status, reset, evict.
Sources & versions3 references Reviewed
  • 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
Reviewed 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