01
Deferred by default
MCP-registered tools come in marked IsDeferred=True. Their schemas are excluded from the per-request tools array, keeping token cost flat regardless of how many MCP servers are attached.
// MCP progressive disclosure
Reveal MCP tools on demand, not up front.
Fat MCP catalogs (Replicate, GitHub MCP) make eager-reveal expensive, so PasClaw applies the Hermes Level 0/1 progressive-disclosure pattern to MCP. Tools register with IsDeferred=True, their schemas are stripped from the per-request tools array, and the model uses a Claude Code-style tool_search to load schemas when it actually needs them.
IsDeferred=True## Deferred Toolsselect / +required / keywordOn by default
02
System prompt lists names
Deferred tools appear by name only under a ## Deferred Tools section in the system prompt, so the model knows what is available without paying for every schema.
03
Three search modes
tool_search loads schemas on demand with select:Name1,Name2 for exact selection, +required keyword pattern for must-include search, or plain keyword search across names and descriptions.
04
Callable next iteration
Revealed tools are callable on the next iteration, so a single tool_search + tool_call pair replaces eagerly shipping dozens of unused schemas every turn.
From the documentation
Technical details
Implementation notes drawn from the PasClaw repository documentation.
Three search modes
tool_search loads deferred MCP tool schemas on demand without sending them up front.
tool_search select:GitHubSearch,GitHubRead
tool_search +required pull request review
tool_search image generationCommon questions
Frequently asked questions
Keep exploring
See how the rest of PasClaw fits together.