Add a user as a member to a HAOps project.

Append a tagged log entry to entity agent memory. Author is auto-populated from the API key. Tag must be allowed for the API key's agent role (e.g. dev can use: context, decision, progress, issue; qa: review, issue; architect/admin: all tags).

Atomically publish multiple skills in a single DB transaction (POST /api/skills/bulk-publish). All version bumps happen in one round-trip; when cascade=true, consumer re-wiring (role templates, skill packs, project protocols) runs ONCE at the end — significantly cheaper than N sequential haops_update_skill calls during mass refactors.

Partial-failure semantics: if ANY entry fails validation (unknown skill name, bad scope+projectSlug combo, duplicate entry), the server rolls back the ENTIRE transaction and returns a 400 with a per-entry error list. No skills are published unless ALL entries are valid. Check totalFailed in the response — 0 means full success.

Admin-only, requires ENABLE_COMPOSED_PROTOCOLS=true. Returns 404 when the feature flag is off (the route looks absent by design).

WARNING: cascade=true re-wires ALL consumers of EVERY updated skill in one transaction. Use haops_preview_skill_cascade on high-impact skills before running to estimate blast radius.

Update multiple issues at once. Useful for batch status changes, priority updates, or reassignments.

Claim a feature for work. Checks availability and marks as in-progress. Use before starting implementation on a feature.

Claim an issue for work. Checks availability and marks as in-progress. Use before starting implementation.

Claim a module for work. Checks availability and marks as in-progress. Use before starting implementation on a module.

Claim or unclaim a helpdesk ticket. Claiming marks it as in-progress and assigns takenBy fields.

Close a merge request without merging. Sets status to "closed".

Resolve or close a helpdesk ticket, optionally sending a final message to the requester. Sends resolution/closure email to requester if message is provided.

Consolidate entity agent memory: replace baseText with updated summary and mark log entries as integrated. Admin and architect roles ONLY. Use this to keep baseText concise by integrating accumulated log entries.

Create a new channel in a HAOps project.

Create a discussion thread in a HAOps project. Two modes: (1) Entity-linked — provide discussableType + discussableId to link to a Module/Feature/Issue (no channelId needed). (2) Channel-based — provide channelId (use haops_list_channels to find it). Can combine both. At least one of channelId or discussableType+discussableId is required.

Create a new documentation artifact for a project. One artifact per type per project.

Create a new section within a documentation artifact. IMPORTANT: Uses artifactSlug (kebab-case slug of the parent artifact, e.g. "deployment" or "api-routes") — NOT the artifact UUID. This is an exception: most other create-* tools use UUID identifiers. Use haops_list_doc_artifacts to find the slug for a given artifact before calling this tool.

Create a new feature in a HAOps module

Create a new help article in a section.

Create a new issue in a HAOps feature

Create a merge request in a HAOps Git repository. Auto-detects conflicts and snapshots commit SHAs. Returns the created MR with status, conflict info, and diff stats.

Create a new module in a HAOps project

Create a PROJECT-SCOPED skill (POST /api/projects/[slug]/skills). Project-scoped skills are visible only to that project's protocol resolver — they cannot be referenced by system role templates or other projects' protocols. For skills you want reusable across all projects, use haops_create_skill with scope="system" instead.

Admin-only, requires ENABLE_COMPOSED_PROTOCOLS=true. Returns 409 if a non-deleted project skill with the same name already exists in this project — use haops_update_skill(scope="project", projectSlug=...) to publish a new version instead. Returns 404 when the feature flag is off.

Response includes id, scope="project", projectId and version=1.

Create a new agent role template (admin-only, requires composed-protocols feature flag). Templates are system-wide (no project scope) and always start at version=1, isCurrent=true, isSystem=false. baseBody is admin-trusted markdown. defaultSkills is the optional bundle of skill IDs auto-enabled when projects adopt the template (required: true makes the skill non-disable-able). Returns the created template row.

Create a new agent skill (system or project-scoped). Inserts version=1 with isCurrent=true. Admin-only on the server, gated by ENABLE_COMPOSED_PROTOCOLS. Returns the new skill row on success; 409 if a skill with the same name already exists in the target scope (use haops_update_skill to publish a new version instead).

Create a new skill pack (admin only, requires ENABLE_COMPOSED_PROTOCOLS=true on the server — returns 404 when the flag is off, by design). Body fields mirror POST /api/skill-packs: kebab-case name (1..100, leading letter), non-empty description, category from the SkillPackCategory enum, and an optional skillIds array of UUID strings (NOT skill names) referencing current, non-deprecated, system-scope Skill rows. isFeatured defaults to false. isSystem is always false here — system packs are seeded (F7-I6), not created via API. Returns the created entity.

Manually create a helpdesk ticket on behalf of a requester (e.g. from an agent, not via public form).

Delete a channel from a HAOps project. This will also delete all discussions in the channel.

Delete a discussion thread. This is permanent and will also delete all messages in the thread. Use with caution.

Delete a documentation artifact and all its sections.

Delete a section from a documentation artifact.

Delete a feature from a HAOps module. If the feature has child issues, requires confirm=true to cascade delete.

Delete a help article. Admin-only.

Delete a help center section and all its articles. Admin-only.

Delete an issue from a HAOps feature. No confirmation needed (issues are leaf nodes with no children).

Delete a message from a discussion thread. Only the message author can delete. This is permanent.

Delete a module from a HAOps project. If the module has child features, requires confirm=true to cascade delete.

Soft-delete a role template, cascading across ALL versions (admin-only, requires composed-protocols feature flag). System templates (isSystem=true) cannot be deleted and return 403 — to "deprecate" a system template, publish a new version via haops_update_role_template or alter the seeder. Soft-deleted rows remain visible in the history endpoint for audit context.

Soft-delete + deprecate a skill (DELETE /api/skills/[name]). Cascades the soft-delete across ALL versions (current + historical) and flips isDeprecated=true on the current row. History remains visible via /api/skills/[name]/history for audit context. Admin-only, gated by ENABLE_COMPOSED_PROTOCOLS. Returns {message, versionCount}.

Soft-delete (deprecate) a skill pack — paranoid destroy on a single row (packs are unversioned, no cascade). Admin only, requires ENABLE_COMPOSED_PROTOCOLS=true. System packs (isSystem=true) cannot be deleted — the server returns 403; to "deprecate" a system pack, update its skillIds to empty via haops_update_skill_pack instead, or remove the seeder entry in code. Returns the server confirmation message.

Metadata-index discovery (ADR-029 P2b): find which doc sections cover a topic BEFORE reading full bodies.

PRIMARY USAGE — filter by scope then pinpoint:

1. relevantTo (controlled vocab) — SCOPE filter: narrows to sections tagged for your role/task. Roles: architect | dev | qa | devops Task-types: rag | helpdesk | auth | mobile | git | testing | memory | deploy | docs | notifications | livekit | email | distribution | communication Pass one or several values; sections matching ANY value are returned.

2. q (free text, case-insensitive, forgiving) — PINPOINT filter: searched over title + summary. Combine with relevantTo for best results.

SECONDARY USAGE — exact tag match (brittle, prefer relevantTo): covers — exact agentMetadata.covers tag match (e.g. "auth-and-roles"). Fails silently if tag is misspelled or not yet indexed. Use only when you know the exact tag.

RETURNS thin rows per matching doc section: { entityType, entityId, title, summary, covers, relevantTo, sectionStatus, stale } Feed entityId into haops_get_doc_section to retrieve the full body.

Example — find RAG-related docs scoped to dev role: { projectSlug: "fdev", relevantTo: ["rag", "dev"], q: "metadata index" }

Download/view an update artifact. For protocols: returns content directly as JSON. For MCP server: returns download instructions with path and size.

Edit an existing message in a discussion thread. Only the message author can edit. Useful for correcting typos or updating information.

Export a documentation artifact as Markdown text. Returns the full Markdown content as a string (not a file download). Useful for syncing documentation to a git repository.

Export a test suite as a JSON bundle for cross-project sharing. Includes suite config and all test definitions.

Generate a changelog from audit logs for a project. Returns structured changelog content.

Generate a Developer Onboarding Kit (ZIP) for a new developer joining a project. Creates pre-configured agent workspace with memory files, agent definitions, and project configuration. The ZIP is saved to a local temp file and the file path is returned.

Get activity log for a specific entity (Module, Feature, or Issue) in a HAOps project. Shows who changed what and when.

Get system-wide audit log (admin only). Shows all changes across the platform with filters.

Compare two branches in a HAOps Git repository. Returns commits ahead/behind, changed files with stats, diff content, and conflict detection. Use before creating an MR to preview changes.

Get detailed information about a specific discussion thread, including metadata and entity linkage.

Retrieve messages from a discussion thread with pagination. Essential for reading conversation context before responding.

Retrieve direct message history with a specific user. Use this to read DM context before replying.

Get a specific documentation section content and metadata.

Get full details for a single feature including title, status, priority, notes, dates, owner, parent module, and child issues.

Get a help article by slug, including full HTML content. Use this before haops_update_help_article when you need to append to existing content (update is wholesale replace).

Get full details for a single issue including title, type, status, priority, notes, points, dates, assignee, and parent feature.

Get merge request detail including diff stats, reviews with verdicts, conflict status, and branch info. Use this to review an MR before approving or merging.

Get full details for a single module including title, status, priority, notes, dates, owner, and child features.

Returns per-role composed-protocol health: missing skill UUIDs, deprecated references, skill pack health, snapshot metadata. Surfaces drift programmatically (same data as the Project Settings → Protocol Health panel in HAOps Desktop UI). Requires ENABLE_COMPOSED_PROTOCOLS=true on the server.

Returns the per-role spawn-line text (GET /api/projects/[slug]/protocol/spawn-lines). Spawn lines are short boot-ritual strings injected at agent session start when composed protocols are active. Omit role to get spawn lines for ALL configured roles; pass a specific role to narrow to one.

Read-only. Requires ENABLE_COMPOSED_PROTOCOLS=true. Returns 404 when the feature flag is off (the route looks absent by design) — surface this as "Composed protocols feature is disabled" to the user.

Returns the full version history of a named role template (GET /api/role-templates/[name]/history). Role templates are system-wide (no scope/projectSlug). Each entry contains version, publication timestamp, author, lifecycle state, and the full baseBody markdown. When diff=true the server computes unified diffs between consecutive versions and includes a diff field per entry.

Use to audit template content over time, recover from a bad publish, or inspect changes before bumping a template with cascade=true.

Returns the full version history of a named skill (GET /api/skills/[name]/history). Each entry contains the version number, publication timestamp, author, lifecycle state, and full content at that point in time. When diff=true the server computes unified diffs between consecutive versions and includes a diff field per entry (empty for v1, which has no predecessor). Use to audit content changes, recover from a bad publish, or inspect the lineage before bumping a high-impact skill.

Administrative note: soft-deleted (deprecated) skills still have their history accessible via this endpoint — paranoid=false on the server join so full audit lineage is preserved.

Get a structured (nested) view of the project work hierarchy with optional filters. Returns Module→Feature→Issue tree, pre-organized for display.

Get aggregated test health summary for a project or specific entity. Returns pass rates, trend, recent failures, and coverage data.

Get a helpdesk ticket by ID, including full conversation timeline (inbound, outbound, internal messages).

Get the diff output for a specific git commit. Essential for code review — shows exactly what changed in a commit.

Get recent commit history from a project's Git repository. Returns commits with SHA, author, date, and message. Supports multi-repo projects via repositoryName.

Get SSH remote URL and setup instructions for pushing to HAOps Git. Returns the SSH URL, default branch, and copy-pasteable setup commands. Supports multi-repo projects via repositoryName.

List files and directories in a project's Git repository at a given path. Returns directory entries with type (file/dir), name, and SHA. Supports multi-repo projects via repositoryName.

Read file content from a project's Git repository. Returns text content for text files, or a "binary file" message for binary files. Supports multi-repo projects via repositoryName.

Import a test suite from a JSON bundle into a project. Creates new suite and test records with fresh UUIDs.

Link tests to a module, feature, or issue by test IDs or file path pattern. Sets testableType and testableId on matching tests.

List all channels in a HAOps project. Use this to discover channel UUIDs needed for creating channel-based discussions via haops_create_discussion.

List discussions in a HAOps project. Filter by entity (Module/Feature/Issue) to find entity-linked discussions, or by channel/status. Essential for the Entity Discussion Protocol — use this to find the discussion linked to a work item before posting.

List all direct message conversations in a project with unread counts and last message previews.

List documentation artifacts for a project. Each artifact represents a type of documentation (architecture, developer, deployment, api, user_guide, changelog, adr, plans).

List all sections in a documentation artifact. Returns section hierarchy with titles, slugs, and order.

List features in a HAOps project with optional filters. Can filter by moduleId to get features for a specific module. Returns feature ID, title, status, priority, owner, module, and issue count.

List help articles, optionally filtered by section slug.

List all help center sections with article counts. Returns published and unpublished sections.

List issues in a HAOps project with optional filters. Can filter by featureId, type, status, priority, and assignee. Returns issue ID, title, status, priority, type, assignee, feature, and dates.

List all members of a HAOps project with their roles and activity stats.

List merge requests for a project with optional filters. Returns MR title, status, branches, author, and timestamps.

List modules in a HAOps project with optional filters. Returns module ID, title, status, priority, owner, and feature count. Use this to discover module UUIDs.

List notifications for the authenticated user/agent. Returns paginated notifications with unread count.

List all projects in HAOps

List all versions of a work protocol for a specific agent role. Returns version numbers, timestamps, change summaries, and who updated each version.

List agent role templates. A role template bundles a core baseBody (boot + scope + handoff markdown) with a set of default skills, and serves as the starting point for an agent role (architect/dev/qa/devops). System templates are seeded; admins may publish project-specific custom templates.

List skill packs — curated bundles of agent skills (e.g. helpdesk-pack, security-pack, mobile-pack) that owners adopt at project onboarding. Each pack groups related skill IDs under a category; the onboarding wizard pre-enables them in one click. System packs are seeded and cannot be deleted. Read-only on the MCP surface; mutations go through the web admin.

List agent skills (system-wide + optionally project-scoped). Skills are reusable, role-tagged knowledge units (e.g. "out-of-scope-findings", "three-layer-boot") that compose into agent protocols. Filter by scope, category, role, project, or free-text search. Deprecated skills are excluded by default.

List recent test runs for a project. Returns run summaries with pass/fail counts.

List tests in a project with optional filters. Returns test records with metadata.

List test suites for a project.

List helpdesk support tickets for a project with optional filters. Returns paginated results.

List available updates for a project. Shows update type, version, status, and date. Use to check for new MCP server versions, protocol changes, test suites, or onboarding templates.

Manage Git repositories for a HAOps project (list, get, create, update, delete). HAOps supports multiple repositories per project.

Manage SSH keys for HAOps Git access (list, add, or revoke). Agents can use this to self-service their SSH keys for git push access.

Mark all direct messages from a specific user as read.

Mark a specific notification as read.

Merge an approved merge request. Checks branch protection rules (required approvals, allowed roles) and conflicts before merging. Supports fast-forward and three-way merge.

Pin or unpin a discussion message.

Post a message to a discussion thread in a HAOps project. Markdown is recommended for agent messages — it will be converted to HTML server-side.

Dry-run the composed-protocol resolver for a project role — returns the assembled manifest as if PUT had been applied, WITHOUT persisting. Use BEFORE haops_update_protocol to verify that the new templateId / skillsConfig combo resolves correctly and has no warnings.

When called with no optional params, previews the current protocol settings (useful for a sanity-check without triggering a version bump).

The response shape mirrors haops_read_protocol (mode, coreContent/body, skillRefs, warnings). The server adds preview: true to distinguish the response from a real read.

Requires ENABLE_COMPOSED_PROTOCOLS=true on the server. Returns 404 when the feature flag is off (the route looks absent, by design) — surface this as "Composed protocols feature is disabled" to the user.

Preview which project protocols would need re-wiring if the named role template is bumped via PUT. Read-only — does not mutate. Use BEFORE calling haops_update_role_template({ ..., cascade: true }) on a high-impact template to estimate blast radius.

Preview which consumers (role templates, skill packs, project protocols) would need re-wiring if the named skill is bumped via PUT. Read-only — does not mutate. Use BEFORE calling haops_update_skill({ ..., cascade: true }) on a high-impact skill to estimate blast radius.

Hybrid BM25+vector retrieval over a HAOps project corpus. Returns top-K chunks with entity citations. Example: { projectSlug: "fdev", text: "F4 manifest cache", topK: 5 }

Add or toggle an emoji reaction on a discussion message.

Read agent memory for a project, module, or feature.

mode="eager" (default): Returns baseText + full log entry bodies. Full project context in one call. mode="lazy" (ADR-027): For entityType=project — returns a compact INDEX envelope: • baseText (already thin) • Architecture doc tree (headers only: title [artifactSlug/sectionSlug]) • ADR index (headers only) • Active work — in-progress modules + features • Log headers only (timestamp · tag · author) — NO bodies Agent then fetches detail on demand via haops_get_doc_section / haops_read_memory(full:true) / haops_rag_query. For entityType=module/feature in lazy mode: falls back to eager (entity baseText is already thin).

Use full=true (eager mode only) to include integrated (historical) log entries. Lazy default can be enabled via HAOPS_MEMORY_LAZY_DEFAULT=true env var on the MCP server.

Read the work protocol for a specific agent role in a project. Protocols define HOW agents should work (scope, workflow, handoff, etc.).

OUTPUT SHAPES (v2.6 — F4 composed protocols): • Legacy project (templateId IS NULL) — always returns the raw monolithic shape regardless of mode: { mode: "legacy", version, bytes, body, content, ... }. The mode and bundle params have no effect; output is byte-identical to v2.5. • Composed project + mode="lazy" (DEFAULT) — { mode: "composed-lazy", version, bytes, body: "", coreContent, skillRefs[], warnings? }. Agent reads coreContent for the boot section, then uses haops_read_skill to fetch individual skill bodies on demand. • Composed project + mode="bundle" — { mode: "composed-bundle", version, bytes, body, skillRefs[], warnings? }. Full composed markdown in body (template baseBody + each enabled skill body + customContent, joined with "---"). Use this when caching offline or when you need the full document in one round-trip. When version is set, returns that specific historical row (raw DB shape — version history predates composed mode; mode/bundle are ignored).

Read a single role template by its kebab-case name. Returns the current version with baseBody (full markdown) + defaultSkills hydrated (each entry includes skill name + description) + ID UUID. Use after haops_list_role_templates to fetch the full template contents.

Read a single skill by its kebab-case name. Returns full markdown content + metadata (category, applicableRoles, version, ID, isDeprecated). Use this after haops_list_skills — or after a haops_read_protocol(mode="lazy") response's skillRefs[] manifest — to fetch the actual instructions on demand.

Reopen a previously closed merge request. Sets status back to "open".

Send a reply or internal note on a helpdesk ticket. direction=outbound sends an email to the requester; direction=internal creates a private team note (not visible to customer).

Report test results to HAOps. Creates a TestRun with individual TestResult records. Used by agents to manually report results (Jest/Playwright reporters do this automatically).

Submit a review on a merge request. Verdicts: approved, changes_requested, commented. When enough approvals are met (per branch protection rules), MR status auto-transitions to approved.

Search messages within a specific discussion thread. Returns matching messages for the given query.

Search help articles by keyword. Returns matching articles with titles and snippets.

Send a direct message to a user in a HAOps project. Supports markdown formatting — content will be converted to HTML server-side.

Transition a role template through its lifecycle (propose / publish / deprecate). Hits POST /api/role-templates/[name]/[action]. Role templates are system-wide — no scope axis. Server enforces the allowed-from-here state machine and returns 409 with allowed on a disallowed transition. System templates (isSystem=true) cannot be deprecated (server returns 403). Admin-only, requires ENABLE_COMPOSED_PROTOCOLS=true.

WARNING: The parameter is named action (values: propose/publish/deprecate) — NOT status or targetStatus. The underlying model field is called status, but the transition route uses action as the URL segment and the tool param name.

Transition a skill through its lifecycle (propose / publish / deprecate). Hits POST /api/skills/[name]/[action]. The server enforces the allowed-from-here state machine — on a disallowed transition you get a 409 with from, to, and the allowed set listed in the response. Admin-only, requires ENABLE_COMPOSED_PROTOCOLS=true on the server. For project-scope skills pass scope="project" + projectSlug.

WARNING: The parameter is named action (values: propose/publish/deprecate) — NOT status or targetStatus. The underlying model field is called status, but the transition route uses action as the URL segment and the tool param name.

Transition a skill pack through its lifecycle (propose / publish / deprecate). Hits POST /api/skill-packs/[name]/[action]. Packs are unversioned and system-wide. Server enforces the allowed-from-here state machine and returns 409 with allowed on a disallowed transition. System packs (isSystem=true) cannot be deprecated (server returns 403 — update skillIds to [] via haops_update_skill_pack instead). Admin-only, requires ENABLE_COMPOSED_PROTOCOLS=true.

WARNING: The parameter is named action (values: propose/publish/deprecate) — NOT status or targetStatus. The underlying model field is called status, but the transition route uses action as the URL segment and the tool param name.

Update an existing channel in a HAOps project.

Update discussion properties (title, status, priority, assignment, locking, pinning). Use this to resolve/close discussions or change metadata.

Update a documentation artifact (title, description, status, version).

Update a documentation section content, title, slug, or source hint. IMPORTANT: Uses artifactSlug (kebab-case slug of the parent artifact, e.g. "deployment" or "api-routes") — NOT the artifact UUID. This is an exception: most other update-* tools use UUID identifiers. Use haops_list_doc_artifacts to find the slug for a given artifact before calling this tool.

Update an existing feature in a HAOps module

Update an existing help article by slug.

Update an existing issue in a HAOps feature

Update a project member's role. Cannot change the owner role.

Update an existing module in a HAOps project

Update (create new version of) the work protocol for a specific agent role in a project. Creates a new version and marks the previous as historical. Architect and admin roles ONLY.

Partial-body support: Provide ONLY the fields you want to change. Server carries forward unchanged fields. • Common usage: pass only templateId to rebind a role template binding without re-sending the full markdown body. • Common usage: pass only skillsConfig to enable/disable skills without re-sending the markdown body. • Pass content only when you actually want to update the markdown text.

F3 composed-protocol fields (ENABLE_COMPOSED_PROTOCOLS must be ON): • templateId — UUID of a RoleTemplate to associate, or null to detach. Omit to carry forward current value. • skillsConfig — override which skills are active and inject custom content. Omit to carry forward. Set to null to clear.

Publish a new version of an existing role template (admin-only, requires composed-protocols feature flag). The server flips the current row to isCurrent=false and inserts a new row at version+1, transactionally. Only supply fields you want to change — a no-op call (no diff) returns the current row unchanged with version untouched. name and isSystem are immutable post-create.

Publish a new version of an existing skill (PUT /api/skills/[name]). Server bumps version in a single transaction. A no-op update (no field differs from current) returns the current row WITHOUT a version bump (mirrors prompt PATCH semantics). At least one mutable field must be supplied. Admin-only, gated by ENABLE_COMPOSED_PROTOCOLS.

Update an existing skill pack in place — no version bump (packs are unversioned; audit log captures the diff). Admin only, requires ENABLE_COMPOSED_PROTOCOLS=true. name and isSystem are immutable post-create. Supply only the fields you want to change; supplying none (or only same-as-current values) is a no-op that returns the current row unchanged (no audit row written). For skillIds, the array is a full replacement, not a patch — pass the complete desired set of UUIDs. Returns the updated entity.

Update helpdesk ticket fields (status, priority, category, assignee, tags). Used for triage and management.

Upload an image to a documentation section. Accepts base64-encoded image data. Returns the attachment record with a URL for embedding in content.

Upload an image to a help article. Accepts base64-encoded image data. Admin-only. Returns the attachment record with a URL for embedding in content.

Run health checks on work entities to detect stale, inconsistent, or problematic states. Returns findings with severity and recommendations.