Get Hedhog updates in your inbox
New releases, fresh recipes, and breaking changes — no spam.

Core Module Documentation
Open SourceThe Core module is the foundation of every HedHog project. It bundles the essential building blocks — authentication, authorization, user management, file handling, mail, AI, dashboards, settings, webhooks, and MCP integration — into a single cohesive package that all other library modules can depend on.
Core is the only Open Source module of the HedHog Framework (MIT licensed). All other modules — including Campaign, LMS, and CRM — are Enterprise modules distributed under a commercial license.
Each submodule below has its own controller, service, and module file under libraries/core/src. Submodules marked Wired are automatically imported by CoreModule; others are available as standalone imports for projects that need only a subset of features.
What are MCP Tools?
MCP (Model Context Protocol) is an open standard that lets AI models interact with external systems through named, structured tools. Each MCP tool exposes a specific action — such as listing records, creating entities, or triggering operations — that an AI assistant can call directly, without requiring the user to write API calls manually. Submodules that expose MCP tools are accessible from any MCP-compatible client, including Claude Desktop and other AI agents integrated with this platform.
Total submodules
30
Wired in CoreModule
28
Not wired in CoreModule
2
access-log
WiredStores and queries HTTP and MCP access logs for auditing.
ai
WiredProvides AI chat flows and AI agent lifecycle endpoints.
auth
WiredHandles authentication, session tokens, MFA and password recovery.
challenge
Not wiredOwns challenge channel providers used by authentication and verification flows.
core/system
WiredExposes runtime and environment system information.
dashboard
WiredManages dashboard definitions, items, templates, sharing and role binding.
file
WiredStores file metadata and generates secure open/download URLs.
install
WiredSupports platform bootstrap and initial installation operations.
integration
WiredProvides outbox/inbox integration infrastructure and domain event orchestration.
integration-profile
WiredConfigures integration profiles, providers and import/export operations.
locale
WiredMaintains locale registry and locale payload used by applications.
Manages mail templates/channels and validation/testing flows.
mail-sent
WiredTracks sent mail messages and their delivery metadata.
mcp
WiredHosts the MCP server endpoint and API key management.
mcp-chat
WiredManages MCP-backed chat conversations and message execution.
menu
WiredBuilds menu trees and role bindings for navigation.
notification
WiredDelivers user notifications including stream and read/progress controls.
oauth
WiredHandles OAuth login/register/connect flows and provider unlink.
Exposes PDF rendering examples and PDF service wrappers.
profile
WiredOwns current-user profile, MFA, recovery codes and personal settings.
role
WiredManages role CRUD and role relations to users, menus, routes and screens.
route
WiredManages HTTP/MCP route registry and permission associations.
screen
WiredManages screen catalog and relations to roles and routes.
security
WiredExposes reusable security primitives consumed by other modules.
session
WiredManages active sessions and session revocation controls.
setting
WiredStores global/user settings and import/export workflow.
task
WiredProvides internal task processing services used by background jobs.
token
Not wiredContains token helpers and providers shared by authentication flows.
user
WiredManages users, avatars and role/menu/route assignments.
webhook-integration
WiredManages inbound webhooks, event catalog and action/log pipelines.