Tool Reference
Wyrm lists 33 MCP tools by default, in 16 areas. These pages are generated on every docs build from what the built server answers to tools/list, so they match what an MCP client sees. Your client's own tool list is the authority for the release you have installed.
More tools can be enabled. Set the WYRM_PROFILE environment variable to legacy (full means the same) and the server lists all 154 names it answers to, including the tool names from 6.x releases. Those older names stay callable without the setting. They are only left out of the default list.
Agent Loop
wyrm_act: Use to pursue a goal autonomously - the OODA loop: observe Wyrm context, orient, decide one whitelisted tool call…wyrm_goal: Use for persistent goals the wyrm-loop daemon pursues autonomously - action=set (define with success criteria), list…
Audit
wyrm_audit: Use for the tamper-evident audit chain - action=log (append a tamper-evident, hash-chained record of an admin action)…
Design Memory
wyrm_design_token: Use for the project's design system - store and read the values the brand uses: color, type, spacing, motion, shadow…wyrm_reference: Use for design references and visual inspiration - action=add (clip a website, image, palette, or snippet to keep for…
Failure Patterns
wyrm_failure_check: Use before proposing or executing any fix, command, or approach - did this fail before? Is it a known landmine?…wyrm_failure_record: Use when an approach failed or something broke - log the dead end so nobody tries it again. Identical (scope, target…
Federation
wyrm_replication: Use to sync memory between machines and watch the live event mesh - action=start|stop|status|tick (daemon + peers…wyrm_share: Use to share a finding with the rest of the team - marks a row (session/quest/truth/artifact/edge) is_shared for the…
Fleet & Presence
wyrm_presence: Use for multi-agent presence - who else is working on this right now? action=list, announce (I'm online and working on…wyrm_run: Use to manage a fleet run lifecycle from the orchestrator: action=start mints a ULID run_id and registers the…
Ground Truths
wyrm_decided_because: Use to link a choice or decision to the assumption or evidence it was based on - records a causal edge…wyrm_decision_trace: Use to trace decision causality - action=upstream (why did we pick this? walk me through the reasoning chain back to…wyrm_truth_get: Use to read the established facts and ground rules for a codebase - validated truths the AI should treat as baseline…wyrm_truth_set: Use to lock in a confirmed fact or constraint as project ground truth - architecture, conventions, key decisions…
Knowledge Graph
wyrm_entity: Use for the knowledge graph - action=add (a person, vendor, service, or concept), link (record that Alice maintains…
Memory Artifacts
wyrm_context_build: Use to build a compact context brief for the current task under a token budget - relevant patterns, lessons, and…wyrm_recall: Use before starting any non-trivial task - what do we know about this? Pull up relevant lessons learned, proven…wyrm_review: Use to process the review queue - approve or reject the pending memory candidates waiting from extraction, harvest…
Meta
buddy: Use when another buddy-compatible MCP server (or the operator) asks Wyrm for a brief, data-grounded status reply - the…wyrm_capabilities: Use to learn what your memory system can actually do - feature inventory, why each matters, runtime state, and which…wyrm_maintenance: Use for periodic upkeep of the memory store - archive old sessions, vacuum, prune stale events, sweep run quarantine…wyrm_stats: Use for a health snapshot of the memory database - row counts, vector index coverage, usage.
Outbound MCP
wyrm_call_external: Use to call a tool on an outbound MCP server registered via wyrm_mcp - lazily spawned over stdio, result returned and…wyrm_mcp: Use to manage outbound MCP servers Wyrm can call - action=register (command, args, env), list, tools (one-shot…
Projects
wyrm_project: Use for the project registry and cross-project landscape - action=list, context (one project's memory overview), scan…
Quests
wyrm_quest: Use for project tasks and todos - action=add (add a todo or work item), complete (mark a task as done), claim (lock a…
Search & Capture
wyrm_capture: Use to save anything worth keeping - the single write funnel. Auto-classifies notes, decisions, and lessons into…wyrm_search: Use to find anything by keyword or meaning across all projects - find past sessions that mention a topic, look up…
Sessions
wyrm_session: Use to track working sessions - action=start (start tracking a new working session on a repo), update (log what you…wyrm_session_prime: Use first at session start - load everything you need to know before starting work, and catch me up on where we left…wyrm_thread: Use to get or nudge the project's working thread: a compact, always-current snapshot (objective, in-progress work…
Skills
wyrm_skill: Use for reusable playbooks (skills) - do we already have a playbook for this? action=list (the playbooks and…