Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
GITHUB_PATNoGitHub Personal Access Token for repository sync (unless --token is supplied).
KB_API_URLNoThe URL of the API server (default is http://localhost:3002).http://localhost:3002
PRIVATE_PINNoPIN required for private scopes.
ANTHROPIC_API_KEYNoAPI key required for query and compile operations.
KB_API_TIMEOUT_MSNoTimeout 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

CapabilityDetails
tools
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

C2.9/5.0

Scored across 37 tools

Disambiguation3/5

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.

Naming Consistency4/5

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.

Tool Count2/5

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.

Completeness4/5

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.