Skip to content
Documentation

Reference

ctx_read

Input contract and parameters for ctx_read.

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.

Example call

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

{
  "name": "ctx_read",
  "arguments": {
    "path": "README.md",
    "mode": "full",
    "fresh": true
  }
}

Parameters

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

aggressivenessnumber

0.0–1.0 density (entropy/task)

engine_interfacestring

Opt into one receipt-backed Engine v1 invocation (single-path aggressive reads only)

Accepted: v1

freshboolean

Bypass cache

limitinteger

Max lines

modestring

Recommended (defaults to auto). full=verbatim(edit-ready) anchored=full+N:hh|anchors(edit via ctx_patch) raw=exact-bytes signatures=API map=structure auto=smart diff=cache-delta lines:N-M=window -N=tail 5,10-20=multi reference=quotes task=focus

offsetinteger

start_line alias

pathstring

Absolute path

pathsarray

Batch read

protectarray

Symbols kept verbatim

rawboolean

Verbatim (= mode=raw + fresh)

start_lineinteger

1-based

Exact JSON schema

Inspect the complete input schema
{
  "properties": {
    "aggressiveness": {
      "description": "0.0–1.0 density (entropy/task)",
      "type": "number"
    },
    "engine_interface": {
      "description": "Opt into one receipt-backed Engine v1 invocation (single-path aggressive reads only)",
      "enum": [
        "v1"
      ],
      "type": "string"
    },
    "fresh": {
      "description": "Bypass cache",
      "type": "boolean"
    },
    "limit": {
      "description": "Max lines",
      "type": "integer"
    },
    "mode": {
      "description": "Recommended (defaults to auto). full=verbatim(edit-ready) anchored=full+N:hh|anchors(edit via ctx_patch) raw=exact-bytes signatures=API map=structure auto=smart diff=cache-delta lines:N-M=window -N=tail 5,10-20=multi reference=quotes task=focus",
      "type": "string"
    },
    "offset": {
      "description": "start_line alias",
      "type": "integer"
    },
    "path": {
      "description": "Absolute path",
      "type": "string"
    },
    "paths": {
      "description": "Batch read",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "protect": {
      "description": "Symbols kept verbatim",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "raw": {
      "description": "Verbatim (= mode=raw + fresh)",
      "type": "boolean"
    },
    "start_line": {
      "description": "1-based",
      "type": "integer"
    }
  },
  "required": [],
  "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
Read source files. mode recommended — choose by intent (see `mode` below); defaults to auto when omitted.
To UNDERSTAND code run ctx_compose FIRST; ctx_read after it identified files.
anchored → edit by reference via ctx_patch (no exact-recall).
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