HAOps MCP Server

List all projects in HAOps

Create a new module in a HAOps project

Update an existing module in a HAOps project

Create a new feature in a HAOps module

Update an existing feature in a HAOps module

Create a new issue in a HAOps feature

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

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

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

Update an existing issue in a HAOps feature

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

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 di…

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 channels in a HAOps project. Use this to discover channel UUIDs needed for creating channel-based discussions via haops_create_discussion.

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.

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

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.

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

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

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

Mark all direct messages from a specific user as read.

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

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

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

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

Add a user as a member to a HAOps project.

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

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.

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

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

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

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

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

List help articles, optionally filtered by section slug.

Create a new help article in a section.

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).

Update an existing help article by slug.

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

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

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

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 s…

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…

Write an agent-authored summary/covers/relevantTo/sectionStatus onto a DocSection's agentMetadata — the agent-facing replacement for the retired Gemma-distiller write path (fdev debf977a). Any caller with project write access can use this; it does NOT require an admin browser session. Read-merge sem…

Get a specific documentation section content and metadata.

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.

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.

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).

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.

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 …

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

Returns per-role composed-protocol health: missing Ability UUIDs, deprecated references, Ability 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.

List agent Abilities (system-wide + optionally project-scoped). Abilities 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 Abilities are excluded b…

Read a single Ability 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. …

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

Publish a new version of an existing Ability (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…

Soft-delete + deprecate an Ability (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 the full version history of a named Ability (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 incl…

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…

Atomically publish multiple Abilities 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, Ability packs, project protocols) runs ONCE at the end — significantly cheaper than N sequential haops_…

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

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-on…

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 par…

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

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.

List agent role templates. A role template bundles a core `baseBody` (boot + scope + handoff markdown) with a set of default Abilities, 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.

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

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 Ability IDs auto-enable…

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 u…

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-dele…

List Ability packs — curated bundles of agent Abilities (e.g. helpdesk-pack, security-pack, mobile-pack) that owners adopt at project onboarding. Each pack groups related Ability IDs under a category; the onboarding wizard pre-enables them in one click. System packs are seeded and cannot be deleted.…

Create a new Ability 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 …

Update an existing Ability 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 va…

Soft-delete (deprecate) an Ability 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…

Transition an Ability 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…

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 templ…

Transition an Ability 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=t…

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).

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

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

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

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

List test suites for a project.

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

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

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.

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.

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.

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.

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.

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

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.

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

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.

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.