On this page
Reference
ctx_cache
Input contract and parameters for ctx_cache.
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.
Parameters
Generated from the registered input schema. “Required” reflects the schema; individual actions can impose additional requirements.
actionstringRequiredstatus|clear|invalidate
Accepted: statusclearinvalidate
pathstringFile path for invalidate action (only used with action=invalidate)
Exact JSON schema
Inspect the complete input schema
{
"properties": {
"action": {
"description": "status|clear|invalidate",
"enum": [
"status",
"clear",
"invalidate"
],
"type": "string"
},
"path": {
"description": "File path for invalidate action (only used with action=invalidate)",
"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
Cache operations — inspect, clear, or invalidate the read cache.
Actions: status lists cached files; clear empties all (recover token budget);
invalidate path=... refreshes a single entry.
Use to diagnose stale content or recover budget after large reads.
ANTIPATTERN: does NOT affect disk files — only cached read content.Sources & versions
- 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