Knowledge Tools
MCP tools for knowledge operations.
search_knowledge
Full-text search across all indexed markdown files (initiatives, tasks, research, agents, rules, skills). Returns ranked results with BM25 scoring. Use this to find relevant files without reading every document.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | yes | Search query — supports FTS5 syntax (AND, OR, NOT, phrase "quotes") |
limit | number | no | Maximum results to return |
kind | string | no | Filter results by file kind |
initiative | string | no | Filter results by parent initiative slug |
mode | string | no | Search mode. 'text' = FTS5 BM25. 'semantic' = TF-IDF embedding similarity (initiative-level). 'hybrid' = reciprocal rank fusion of both. |
get_summary
Get structured metadata and summaries at different zoom levels. 'file' returns metadata for a single file. 'initiative' returns generated summary, file list, and edges. 'portfolio' returns all initiative summaries weighted by status — the system-wide view.
| Parameter | Type | Required | Description |
|---|---|---|---|
path | string | no | File path (relative to project root) — used when level='file' |
initiative | string | no | Initiative slug — used when level='initiative' |
level | string | no | Summary level. 'file' = single file metadata. 'initiative' = initiative summary + files + edges. 'portfolio' = all initiative summaries. |
get_context
Session bootstrap — get role-appropriate system state in a single call. Workers get deep scope, Planners get deep system overview, Judges get scope + neighborhood. Returns everything an agent needs to orient without reading individual files.
| Parameter | Type | Required | Description |
|---|---|---|---|
role | string | yes | Agent role — determines what zoom level of context is returned |
initiative | string | no | Initiative slug to scope context to |
max_tokens | number | no | Override token budget (default varies by role) |
query_related
Find related initiatives. 'explicit' traverses frontmatter edges (depends-on, informs, spawned-from). 'emergent' finds initiatives with high embedding similarity but no explicit edge — hidden connections. 'creative' finds initiatives that are semantically close but structurally far apart — cross-pollination candidates.
| Parameter | Type | Required | Description |
|---|---|---|---|
source | string | yes | Initiative slug to find relationships for |
mode | string | no | Relationship mode |
limit | number | no | Maximum results |