Skip to main content
Glama
haver-governance-mcp

haver-governance-mcp

Official
by haverAI

Haver Governance MCP

Identity, permission, audit, and recall for healthcare AI agents, delivered over the Model Context Protocol (MCP).

As organizations deploy more AI agents into clinical and operational workflows, the missing layer is governance: knowing which agent is acting, whether it is allowed to, having a tamper-evident record of what it did, and being able to revoke it. Haver Governance MCP gives any MCP-compatible client (such as Claude) a small set of tools to enforce and record that governance at runtime.

This is an open-source reference implementation from Haver AI, the governance layer for healthcare AI.

What it does

Tool

Pillar

What it does

register_agent

Identity

Registers an agent with a stable id, owner, role, and permission scopes.

check_permission

Permission

Decides whether an agent may take an action on a resource. Denies unknown or recalled agents. Logs the decision.

record_action

Audit

Appends a tamper-evident, hash-chained record of an agent action.

get_audit_trail

Audit

Returns recent audit entries, filterable by agent or resource.

verify_audit_integrity

Audit

Recomputes the hash chain and reports whether the log was tampered with.

recall_agent

Recall

Revokes an agent so every future permission check denies it.

scan_phi

Safety

Heuristically flags and redacts common PHI (SSN, MRN, email, phone, dates).

Scopes use a simple action:resource form, for example read:labs or write:notes, and support * wildcards (read:*, *:*).

Related MCP server: Agent Audit Trail MCP Server

Install

Run it directly with npx (no global install needed):

npx -y haver-governance-mcp

Use it in Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "haver-governance": {
      "command": "npx",
      "args": ["-y", "haver-governance-mcp"]
    }
  }
}

Restart Claude, and the seven governance tools appear.

Example flow

  1. register_agent an intake assistant with scopes: ["read:labs"].

  2. check_permission for read on labs returns allow; write on notes returns deny.

  3. record_action logs each real action it takes, flagging contains_phi when relevant.

  4. If the agent misbehaves, recall_agent revokes it; future checks deny.

  5. verify_audit_integrity proves the log has not been altered.

Data and privacy

All state is stored locally as plain files: agent records in agents.json and the audit log in audit.log, under ~/.haver-governance by default (override with the HAVER_GOV_DIR environment variable). Nothing is transmitted anywhere. The audit log is append-only and hash-chained for tamper evidence. See PRIVACY.md.

The scan_phi tool is a heuristic guardrail to catch obvious leaks. It is not a certified de-identification tool and should not be relied on as one.

Development

npm install
npm run build
node dist/index.js   # runs on stdio

Requires Node.js 18 or later. Built with the official @modelcontextprotocol/sdk and Zod.

Publishing

This package is published to npm and listed in the official MCP Registry. See PUBLISHING.md for the exact steps.

About Haver AI

Haver AI is the governance layer for healthcare AI: identity, permission, audit, and recall for every agent your organization deploys. Learn more at haver.ai.

License

MIT. See LICENSE.

Available Tools

7 tools
check_permissionCheck agent permissionA

Decide whether a registered agent may perform an action on a resource, based on its scopes and status. Recalled or unknown agents are always denied. The decision is written to the audit log.

Inputs: action (required), agent_id (required), resource (required).

get_audit_trailGet audit trailC

Return recent audit entries, optionally filtered by agent or resource.

Inputs: limit, agent_id, resource.

recall_agentRecall (revoke) an agentA

Revoke an agent so all future permission checks deny it. Use when an agent misbehaves or is decommissioned. The recall is audited.

Inputs: reason (required), agent_id (required).

record_actionRecord an agent action (audit)B

Append a tamper-evident audit record for something an agent did. Entries are hash-chained, so any later modification is detectable.

Inputs: action (required), outcome (required), agent_id (required), resource (required), +2 more.

register_agentRegister agent identityA

Register an AI agent with a stable identity, owner, role, and permission scopes. Scopes use the form 'action:resource' (e.g. 'read:labs'), and '*' wildcards are allowed.

Inputs: name (required), role (required), owner (required), scopes (required), +1 more.

scan_phiScan text for PHIA

Heuristically scan text for common protected health information (SSN, MRN, email, phone, dates) and return findings plus a redacted copy. A guardrail, not a certified de-identification tool.

Inputs: text (required).

verify_audit_integrityVerify audit-log integrityA

Recompute the audit hash chain and report whether the log is intact or has been tampered with.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a unique purpose: permission checking, audit trail retrieval, agent recall, action recording, agent registration, PHI scanning, and integrity verification. No two tools overlap or could be confused.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern (e.g., check_permission, register_agent, scan_phi) with imperative verbs and descriptive nouns. No mixing of styles or vague names.

    Tool Count5/5

    Seven tools is well-scoped for a governance server covering agent lifecycle, permissions, audit, and integrity. Each tool earns its place without being excessive or insufficient.

    Completeness5/5

    The tool surface covers core CRUD-like operations for agents (register, recall), permissions (check), audit (record, get, verify integrity), and adds a guardrail (scan_phi). No obvious gaps for the domain.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to sign decisions with post-quantum cryptographic proofs and maintain secure audit trails for compliance. It provides tools for stamping events, verifying chain integrity, and exporting audit data across industries like finance and healthcare.
      4
      81 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Issues accountable identities for AI agents before they interact with tools, with tools for identity management and receipt export.
      -