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

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

Related MCP server: PiQrypt 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.