morpheus-mcp

Load a plan file into Morpheus and begin tracking state.

Parses the markdown plan file, saves plan and tasks to the store, and returns a summary with task list and IDs.

Args: plan_file: Filesystem path to the plan markdown file

Get current plan progress, task states, and active phase.

If plan_id is omitted, returns the most recently created plan.

Args: plan_id: Plan ID (optional — defaults to most recent plan)

Advance a task through a phase gate with evidence.

Validates that the evidence satisfies the gate requirements. Returns success with next phase instructions, or rejection with details on what's missing.

Args: task_id: The task ID to advance phase: Phase name: CHECK, CODE, TEST, GRADE, COMMIT, or ADVANCE evidence: JSON string with evidence key-value pairs skip_reason: When provided, fills missing evidence keys to bypass the gate. Use for intentional skips (e.g., "greenfield — no diff for Seraph"). Recorded in evidence for auditability.

Advance multiple tasks through phase gates in a single call.

Processes each advance sequentially. Stops at the first failure. Accepts a JSON array of objects with keys: task_id, phase, evidence.

Args: advances: JSON array of {task_id, phase, evidence} objects

Log progress for a task without advancing phases.

Purely observational — records a timestamped message for the task. Visible in morpheus_status output for the active task.

Args: task_id: The task ID to log progress for message: Progress message to record

Mark a plan as completed and return final summary.

Args: plan_id: The plan ID to close

Record an oil change (macro-lens health check) for a plan.

Call this after running sentinel_health_check and reviewing the results. Clears any oil_change_due advisory on the plan.

Args: plan_id: The plan ID to record the oil change for health_check_id: The sentinel_health_check result ID commits_since_last: Number of commits since last health check

Record whether a gate caught a real issue or was ceremony.

Call this after each gate fires to build the Reflect dataset. Over time, this data reveals which gates produce value and which burn tokens without changing behavior.

Args: plan_id: The plan ID task_id: The task ID gate: Gate name (e.g., "sibling_read", "fdmc_review", "seraph_assess", "knowledge_gate") caught_issue: True if the gate found something actionable changed_code: True if code was modified because of this gate detail: Brief description of what happened (e.g., "matched singleton pattern from sibling" or "no issues found")

Summarize gate outcomes: how often each gate fired, caught issues, changed code.

Returns lifetime stats across all plans if plan_id is omitted. Use this to identify which gates produce value and which are ceremony.

Args: plan_id: Optional plan ID to scope the summary

Return Morpheus server version, plan schema version, and Python version.

No arguments required. Use for introspection and compatibility checks.