HAI-MCP

Model-agnostic Human-Agent Interface control plane as an MCP server.

Any client (Claude Code, Codex, Cursor, Grok, OpenCode, Hermes, …) can use the same tools. The server never calls an LLM.

Install / run

cd HAI-MCP
uv sync --all-extras
uv run hai-mcp

stdio MCP. Point your client at:

{
  "command": "uv",
  "args": ["run", "--directory", "/absolute/path/to/HAI-MCP", "hai-mcp"],
  "env": {
    "HAI_HOME": "/home/you/.hai"
  }
}

Related MCP server: Keshro MCP

Tools (v1)

See docs/TOOL_CONTRACT.md.

State

• Global: $HAI_HOME (default ~/.hai)

• Per project: <project>/Projek-Managment/

Legacy

~/.config/hai-agent-mcp is Hermes-coupled prior art. This repo replaces that role for control-plane work; coexistence is fine until you switch clients deliberately.

Tests

uv run pytest