HEM MCP Server

Model Context Protocol server for the Hedonistic Method (HEM) — exposes project management, governance, measurement, and workflow tools to any MCP-capable AI host.

Built on @modelcontextprotocol/sdk and @hedonistic-io/hem-core.

MCP Tools

The server registers tools across several domains:

Project Management

Tool	Description
hem_init	Initialize a HEM-governed project with a profile
hem_status	Get project status (profile, phase, health)
hem_detect	Auto-detect project type and suggest a profile

Governance & Validation

Tool	Description
hem_validate	Validate a project against HEM governance rules
hem_validate_compact	Validate a compact (session contract) file
hem_lint_compact	Lint a compact for structural issues
hem_lint_accord	Lint an accord document
hem_lint_amendment	Lint an amendment document
hem_lint_tasks	Lint a tasks file
hem_reject	Record a governance rejection
hem_rejection_list	List recorded rejections
hem_rejection_summary	Summarize rejection patterns
hem_rejection_resolve	Resolve a recorded rejection
hem_hallucination_rate	Calculate hallucination rate from rejections

Measurement (Hedonistic Index)

Tool	Description
hem_measure	Calculate the full Hedonistic Index from signals
hem_measure_quick	Quick HI measurement (enjoyment, fulfillment, desire to continue)

Knowledge & Memory

Tool	Description
hem_knowledge_store	Store a knowledge entry
hem_knowledge_recall	Recall knowledge by query
hem_knowledge_corroborate	Corroborate knowledge across sources
hem_knowledge_distribution	Analyze knowledge distribution
hem_memory_append	Append to session memory
hem_memory_recall	Recall session memory
hem_memory_sessions	List memory sessions
hem_memory_distill	Distill session memory to knowledge

Workflow & Profiles

Tool	Description
hem_compact_read	Read a compact file
hem_compact_create	Create a new compact
hem_compact_update	Update an existing compact
hem_profile_get	Get a specific profile definition
hem_profile_list	List all available profiles
hem_profile_set	Set the active profile for a project
hem_brief_assemble	Assemble a context brief for an agent
hem_changelog_read	Read the changelog
hem_changelog_add	Add a changelog entry
hem_escalation_check	Check for escalation conditions
hem_skills_list	List available HEM skills
hem_template_render	Render a HEM template

Estimation

Tool	Description
hem_estimate_record	Record an estimation
hem_estimate_adjust	Adjust an estimate with calibration data
hem_estimate_calibration	View calibration factor
hem_estimate_harvest	Harvest calibration data from completed tasks

Task Management

Tool	Description
hem_tasks_list	List tasks
hem_tasks_add	Add a new task
hem_tasks_complete	Mark a task complete
hem_tasks_update	Update task metadata

Archive & Signing

Tool	Description
hem_archive_transcript	Archive a session transcript
hem_archive_prompt	Archive a prompt
hem_archive_output	Archive an output
hem_archive_diff	Archive a diff
hem_archive_search	Search the archive
hem_archive_transcript_get	Retrieve an archived transcript
hem_archive_export	Export archive data
hem_sign_file	Sign a file
hem_sign_verify	Verify a signature
hem_sign_keys	Manage signing keys

Steering & Engines

Tool	Description
hem_steer_analyze	Analyze project for steering alerts
hem_steer_prompt	Generate a steering prompt
hem_steer_scope_check	Check scope compliance
hem_engines_list	List configured AI engines
hem_engines_available	List available (installed) engines
hem_engines_launch	Launch an engine for a task

Configuration

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "hem": {
      "command": "npx",
      "args": ["-y", "@hedonistic-io/hem-mcp-server"]
    }
  }
}

Or if installed locally:

{
  "mcpServers": {
    "hem": {
      "command": "node",
      "args": ["/path/to/method-hem-mcp/packages/hem-mcp-server/dist/server.js"]
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "hem": {
      "command": "npx",
      "args": ["-y", "@hedonistic-io/hem-mcp-server"]
    }
  }
}

Windsurf

Add to ~/.windsurf/mcp.json:

{
  "mcpServers": {
    "hem": {
      "command": "npx",
      "args": ["-y", "@hedonistic-io/hem-mcp-server"]
    }
  }
}

Development

# Install dependencies
npm install

# Build both packages
npm run build

# Run tests
npm test

# Start the server (stdio transport)
npm start

Related

• Hedonistic Method — the full HEM framework (profiles, rules, modules, shell integrations)
• Model Context Protocol — the MCP specification

License

MIT - Hedonistic IO LLC