On this page
Reference
ctx_control
Input contract and parameters for ctx_control.
MCP tool · Planning 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.
actionstringRequiredexclude|include|pin|unpin|set_view|set_priority|mark_outdated|reset|list|history
reasonstringReason for the action
scopestringcall (this turn only), session (rest of this session), project (persists)
targetstring@F1 handle (ctx_compile reference) or file path or item ID
valuestringNew content, view name, or priority
Exact JSON schema
Inspect the complete input schema
{
"properties": {
"action": {
"description": "exclude|include|pin|unpin|set_view|set_priority|mark_outdated|reset|list|history",
"type": "string"
},
"reason": {
"description": "Reason for the action",
"type": "string"
},
"scope": {
"description": "call (this turn only), session (rest of this session), project (persists)",
"type": "string"
},
"target": {
"description": "@F1 handle (ctx_compile reference) or file path or item ID",
"type": "string"
},
"value": {
"description": "New content, view name, or priority",
"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
Fine-tune context — exclude, include, pin, unpin, set_view, set_priority, mark_outdated, reset, list, history.
Overlay-based, reversible, scoped to call/session/project.
WORKFLOW: after ctx_compose, exclude low-relevance files.
ANTIPATTERN: not for initial context building — use ctx_compose/ctx_read first.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