Skip to main content
Glama
circadian-phase-angle

circadian-phase-angle

by Alpha-Park

Circadian Phase Angle of Entrainment & Internal Desynchrony Skill

License: MIT Python 3.10+ Zero Dependencies OpenClaw Ready MCP Protocol

A sovereign personal agent capability for computational chronobiology, evaluating phase angles of entrainment ($\psi$), internal circadian desynchrony, and photic Phase Response Curve (PRC) adjustments.

Architecture

flowchart TD
    Markers["Biomarkers: DLMO (Melatonin Onset) & CBTmin"] --> AngleCalc["Phase Angle Calculator (psi_DLMO_SO & psi_CBT_Wake)"]
    SleepSchedule["Sleep Log: Sleep Onset & Awakening Time"] --> AngleCalc
    AngleCalc --> ICDS["Internal Circadian Desynchrony Scoring (ICDS: 0-100)"]
    ICDS --> PRCEngine["Photic PRC Engine (Advance / Delay / Dead Zone)"]
    PRCEngine --> ActionPlan["OpenClaw / Hermes Solar & Screen Curfew Guidance"]

Related MCP server: Personal Agent Sleep Debt Repayment Planner

Quickstart

from client import CircadianPhaseAngleClient

client = CircadianPhaseAngleClient()

# Calculate internal phase angle of entrainment
res = client.calculate_phase_angle_of_entrainment(
    dlmo_time_str="21:45",
    sleep_onset_time_str="23:30",
    wake_time_str="07:15"
)

print("psi (DLMO -> Sleep Onset):", res["psi_dlmo_to_sleep_onset_hours"], "h")
print("Desynchrony Score:", res["internal_circadian_desynchrony_score"], "/ 100")
print("Status:", res["status"])

MCP Server Integration

Add to your claude_desktop_config.json or OpenClaw tool registry:

{
  "mcpServers": {
    "circadian-phase-angle": {
      "command": "python",
      "args": ["/path/to/genpark-personal-agent-circadian-phase-angle-entrainment-skill/mcp_server.py"]
    }
  }
}

License

MIT License.

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    B
    maintenance
    Enables users to calculate chronotype-aligned sleep schedules, optimize 90-minute ultradian cycles, determine caffeine cutoffs, and plan light exposure for better recovery and circadian alignment.
    7
    -
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables modeling cumulative sleep deficits, estimating cognitive impairment through PVT attention lapses and BAC equivalence, auditing social jetlag, and generating circadian-safe gradual sleep repayment schedules.
    7
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables users to model cumulative sleep deficits, estimate cognitive impairment using Van Dongen PVT kinetics, audit social jetlag, and generate circadian-safe gradual sleep repayment schedules.
    7
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables computing MCTQ mid-sleep chronotype and social jetlag from workday and free-day sleep schedules, then projecting circadian biological phase windows such as CAR peak, focus periods, caffeine cutoff, DLMO, and sleep gate from a target wake time.
    7
    MIT