zeroclaw/docs
Vernon Stinebaker a52446c637
feat(agent): add tool_filter_groups for per-turn MCP tool schema filtering (#3395)
* feat(agent): add tool_filter_groups for per-turn MCP tool schema filtering

Introduces per-turn MCP tool schema filtering to reduce token overhead when
many MCP tools are registered. Filtering is driven by a new config field
`agent.tool_filter_groups`, which is a list of named groups that each
specify tool glob patterns and an activation mode (`always` or `dynamic`).

Built-in (non-MCP) tools always pass through unchanged; the feature is fully
backward-compatible — an empty `tool_filter_groups` list (the default) leaves
all existing behaviour untouched.

Changes:
- src/config/schema.rs: add `ToolFilterGroupMode`, `ToolFilterGroup` types
  and `tool_filter_groups` field on `AgentConfig`
- src/config/mod.rs: re-export `ToolFilterGroup`, `ToolFilterGroupMode`
- src/agent/loop_.rs: add `glob_match()`, `filter_tool_specs_for_turn()`,
  `compute_excluded_mcp_tools()` helpers; wire call sites in both single-shot
  and interactive REPL modes; add unit tests for all three functions
- docs/reference/api/config-reference.md: document `tool_filter_groups`
  field and sub-table schema with example
- docs/i18n/el/config-reference.md: add Greek locale config-reference with
  `tool_filter_groups` section (2026-03-12 update)

* Remove accidentally committed worktree directories

---------

Co-authored-by: argenis de la rosa <theonlyhennygod@gmail.com>
2026-03-13 14:23:57 -04:00
..
assets docs: restructure docs/ into topic-based directory layout 2026-03-09 22:25:20 -04:00
contributing chore(github): update review ownership routing (#3216) 2026-03-11 19:11:53 -04:00
hardware chore: migrate GitHub URLs from theonlyhennygod to zeroclaw-labs 2026-03-09 23:49:56 -04:00
i18n feat(agent): add tool_filter_groups for per-turn MCP tool schema filtering (#3395) 2026-03-13 14:23:57 -04:00
maintainers fix(docs): correct default branch in triage snapshot (#3253) 2026-03-11 23:45:34 -04:00
ops docs: replace main branch references with master (#3194) 2026-03-11 21:54:08 -04:00
reference feat(agent): add tool_filter_groups for per-turn MCP tool schema filtering (#3395) 2026-03-13 14:23:57 -04:00
security docs: update all internal links to match topic-based directory layout 2026-03-09 23:09:09 -04:00
setup-guides docs: replace main branch references with master (#3194) 2026-03-11 21:54:08 -04:00
vi feat(agent): add tool_call_dedup_exempt config to bypass within-turn dedup (#2978) 2026-03-12 10:28:42 -04:00
README.fr.md docs: update all internal links to match topic-based directory layout 2026-03-09 23:09:09 -04:00
README.ja.md docs: update all internal links to match topic-based directory layout 2026-03-09 23:09:09 -04:00
README.md docs: update all internal links to match topic-based directory layout 2026-03-09 23:09:09 -04:00
README.ru.md docs: update all internal links to match topic-based directory layout 2026-03-09 23:09:09 -04:00
README.vi.md docs: update all internal links to match topic-based directory layout 2026-03-09 23:09:09 -04:00
README.zh-CN.md docs: update all internal links to match topic-based directory layout 2026-03-09 23:09:09 -04:00
SUMMARY.fr.md docs: update all internal links to match topic-based directory layout 2026-03-09 23:09:09 -04:00
SUMMARY.ja.md docs: update all internal links to match topic-based directory layout 2026-03-09 23:09:09 -04:00
SUMMARY.md test: restructure test suite into five-level taxonomy 2026-03-11 11:03:33 -04:00
SUMMARY.ru.md docs: update all internal links to match topic-based directory layout 2026-03-09 23:09:09 -04:00
SUMMARY.zh-CN.md docs: update all internal links to match topic-based directory layout 2026-03-09 23:09:09 -04:00

ZeroClaw Documentation Hub

This page is the primary entry point for the documentation system.

Last refreshed: February 21, 2026.

Localized hubs: 简体中文 · 日本語 · Русский · Français · Tiếng Việt.

Start Here

I want to… Read this
Install and run ZeroClaw quickly README.md (Quick Start)
Bootstrap in one command one-click-bootstrap.md
Update or uninstall on macOS macos-update-uninstall.md
Find commands by task commands-reference.md
Check config defaults and keys quickly config-reference.md
Configure custom providers/endpoints custom-providers.md
Configure Z.AI / GLM provider zai-glm-setup.md
Use LangGraph integration patterns langgraph-integration.md
Operate runtime (day-2 runbook) operations-runbook.md
Troubleshoot install/runtime/channel issues troubleshooting.md
Run Matrix encrypted-room setup and diagnostics matrix-e2ee-guide.md
Browse docs by category SUMMARY.md
See project PR/issue docs snapshot project-triage-snapshot-2026-02-18.md

Quick Decision Tree (10 seconds)

By Audience

Users / Operators

Contributors / Maintainers

Security / Reliability

Note: this area includes proposal/roadmap docs. For current behavior, start with config-reference.md, operations-runbook.md, and troubleshooting.md.

System Navigation & Governance