Agentic-KB
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GITHUB_PAT | No | GitHub Personal Access Token for repository sync (unless --token is supplied). | |
| KB_API_URL | No | The URL of the API server (default is http://localhost:3002). | http://localhost:3002 |
| PRIVATE_PIN | No | PIN required for private scopes. | |
| ANTHROPIC_API_KEY | No | API key required for query and compile operations. | |
| KB_API_TIMEOUT_MS | No | Timeout in milliseconds for API requests. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_wikiB | Search the Agentic Engineering Knowledge Base for articles matching a query. |
| read_articleB | Read the full content of a wiki article by its slug (e.g. "concepts/tool-use"). Private articles require a pin. |
| read_indexB | Read the wiki master index (index.md) — lists all articles by section. |
| list_articlesB | List articles in a specific wiki section. |
| query_wikiA | Ask a natural language question against the KB using the AI WikiQuery engine. Returns a synthesized answer with citations. |
| compile_wikiB | Process uncompiled raw documents and compile them into structured wiki pages using Claude. Use mode="incremental" for new docs only (default) or mode="full" to recompile everything. |
| load_agent_contextC | Load a scoped context bundle for an agent, respecting its contract (tier, budget, allowed reads). |
| close_agent_taskA | Transactional end-of-task writeback for an agent: appends task log, updates hot, writes gotchas, publishes discoveries/escalations, creates rewrites. Atomic — any forbidden write aborts the whole commit. |
| publish_bus_itemC | Publish an item to a bus channel (discovery, escalation, standards, handoffs). |
| list_agent_bus_itemsC | List items in a bus channel, optionally filtered by status. |
| promote_learningC | Promote a bus item to a target knowledge location with provenance; marks source as promoted. |
| merge_rewriteA | Merge an approved rewrite artifact into the canonical project document. Snapshots previous canonical, writes new with provenance, transitions rewrite to merged. Requires rewrite to be in approved state and approver to meet minimum tier. |
| agent_traceA | Return recent runtime traces (context loads and close-task writes) for an agent from logs/agent-runtime.log. Useful for debugging context budget issues and rejected writes. |
| list_agentsB | List all agent contracts in the vault. |
| lint_wikiA | Run a health check on the wiki: detects contradictions between pages, orphaned pages with no links, stale content, and knowledge gaps. Writes a lint-report.md to the wiki. |
| list_reposB | List all tracked repos with their sync status and doc counts. |
| get_repo_homeC | Get the home page and overview for a tracked repo. |
| sync_repo_markdownA | Sync a repository from GitHub — fetches markdown docs (.md/.mdx: README/CLAUDE.md plus docs/, specs/, plans/, reports/, architecture/; vendored dirs excluded) and writes them to wiki/repos//repo-docs/, recording sync state in the registry. |
| search_repo_docsC | Full-text search within a specific repo namespace (canonical docs, imported docs, bus). |
| load_repo_contextC | Load prioritized context bundle for an agent working on a specific repo. |
| append_repo_progressC | Append a progress entry to wiki/repos//progress.md. |
| write_repo_task_logC | Append a task log entry for an agent working on a repo. |
| close_repo_taskB | Transactional end-of-task writeback for a repo-scoped agent workflow. Appends progress, updates hot memory, writes gotchas, publishes discoveries/escalations, and creates rewrites atomically. |
| dry_run_close_repo_taskA | Dry-run a repo close-task operation and return the full write plan without executing any writes. |
| write_rewrite_artifactC | Create a rewrite artifact in wiki/repos//rewrites//. |
| publish_repo_discoveryC | Publish a discovery bus item to wiki/repos//bus/discovery/. |
| publish_repo_escalationC | Publish an escalation bus item to wiki/repos//bus/escalation/. |
| list_repo_bus_itemsC | List bus items for a repo channel (discovery, escalation, standards, handoffs). |
| promote_repo_learningC | Promote a repo bus item to a canonical or learned location with provenance. |
| agent_start_taskA | Start a new task for an agent. Creates a working-memory file and sets active-task.md pointer. Returns taskId and paths. |
| agent_active_taskB | Return the current active task metadata for an agent, or null if no task is active. |
| agent_statusB | Return agent lifecycle status: active task, verification issues, close policy, and recent runtime traces. |
| agent_verify_stateB | Verify task lifecycle consistency for an agent. Detects broken active-task pointers and orphan active working-memory files. |
| agent_repair_stateB | Attempt safe repair of an agent task lifecycle state. Rebuilds or clears the active-task pointer when it can do so safely. |
| agent_append_task_stateB | Append a timestamped state entry to the active working-memory file. Requires an active task. |
| agent_abandon_taskB | Mark an active task as abandoned. Sets status in working-memory and clears the active-task pointer. |
| agent_dry_run_close_taskA | Dry-run a close-task operation — returns the full write plan (allowed/rejected ops, bus publications, file writes) without executing anything. Useful for validating a payload before committing. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 37 tools
There are parallel general and repo-scoped tools (e.g., close_agent_task vs close_repo_task, publish_bus_item vs publish_repo_discovery/escalation, promote_learning vs promote_repo_learning) that can be confused. Multiple agent state tools (status, verify, repair, trace) also overlap in lifecycle focus, though descriptions help clarify scope.
Names consistently use snake_case and mostly follow verb_noun or noun_verb patterns. Minor deviations exist, such as agent_* prefix tools (agent_status, agent_verify_state) mixed with verb-first names, and dry_run_close_repo_task vs agent_dry_run_close_task ordering.
With 37 tools, the surface is heavy for a knowledge base server. Many parallel repo/agent variants (e.g., close_agent_task, close_repo_task, dry_run_close_repo_task, agent_dry_run_close_task) could likely be consolidated.
The toolset covers core wiki operations (read, search, list, query, compile), full agent lifecycle (start, active, status, verify, repair, append, abandon, close, trace), bus publishing, repo sync/context/task close, and rewrites. Minor gaps include explicit article delete/update and agent contract management, but most workflows are supported.