Logotipo Hedhog

Get Hedhog updates in your inbox

New releases, fresh recipes, and breaking changes — no spam.

Core module overview

Core Module Documentation

Open Source

The 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

Wired

Stores and queries HTTP and MCP access logs for auditing.

1 endpoints0 MCP tools

ai

Wired

Provides AI chat flows and AI agent lifecycle endpoints.

8 endpoints8 MCP tools

auth

Wired

Handles authentication, session tokens, MFA and password recovery.

15 endpoints0 MCP tools

challenge

Not wired

Owns challenge channel providers used by authentication and verification flows.

0 endpoints0 MCP tools

core/system

Wired

Exposes runtime and environment system information.

1 endpoints1 MCP tools

dashboard

Wired

Manages dashboard definitions, items, templates, sharing and role binding.

53 endpoints2 MCP tools

file

Wired

Stores file metadata and generates secure open/download URLs.

8 endpoints5 MCP tools

install

Wired

Supports platform bootstrap and initial installation operations.

3 endpoints0 MCP tools

integration

Wired

Provides outbox/inbox integration infrastructure and domain event orchestration.

0 endpoints1 MCP tools

integration-profile

Wired

Configures integration profiles, providers and import/export operations.

11 endpoints0 MCP tools

locale

Wired

Maintains locale registry and locale payload used by applications.

2 endpoints0 MCP tools

mail

Wired

Manages mail templates/channels and validation/testing flows.

9 endpoints7 MCP tools

mail-sent

Wired

Tracks sent mail messages and their delivery metadata.

5 endpoints3 MCP tools

mcp

Wired

Hosts the MCP server endpoint and API key management.

4 endpoints0 MCP tools

mcp-chat

Wired

Manages MCP-backed chat conversations and message execution.

6 endpoints5 MCP tools

menu

Wired

Builds menu trees and role bindings for navigation.

13 endpoints11 MCP tools

notification

Wired

Delivers user notifications including stream and read/progress controls.

9 endpoints8 MCP tools

oauth

Wired

Handles OAuth login/register/connect flows and provider unlink.

9 endpoints0 MCP tools

pdf

Wired

Exposes PDF rendering examples and PDF service wrappers.

1 endpoints0 MCP tools

profile

Wired

Owns current-user profile, MFA, recovery codes and personal settings.

30 endpoints5 MCP tools

role

Wired

Manages role CRUD and role relations to users, menus, routes and screens.

13 endpoints13 MCP tools

route

Wired

Manages HTTP/MCP route registry and permission associations.

9 endpoints9 MCP tools

screen

Wired

Manages screen catalog and relations to roles and routes.

9 endpoints9 MCP tools

security

Wired

Exposes reusable security primitives consumed by other modules.

0 endpoints0 MCP tools

session

Wired

Manages active sessions and session revocation controls.

5 endpoints5 MCP tools

setting

Wired

Stores global/user settings and import/export workflow.

17 endpoints8 MCP tools

task

Wired

Provides internal task processing services used by background jobs.

0 endpoints0 MCP tools

token

Not wired

Contains token helpers and providers shared by authentication flows.

0 endpoints0 MCP tools

user

Wired

Manages users, avatars and role/menu/route assignments.

14 endpoints13 MCP tools

webhook-integration

Wired

Manages inbound webhooks, event catalog and action/log pipelines.

32 endpoints3 MCP tools