Moira — Claude Code MCP server: features and setup
Moira runs multi-step agent workflows over MCP and saves run state, so another agent session can pick up where the previous one stopped.
Open on GitHubWhat Moira does
An agent receives instructions and completion criteria, performs the work, then submits a response for schema validation. That check verifies the response shape, not whether the work was actually done. Moira keeps execution state across sessions. Its web interface supports workflow editing and run inspection.
Self-hosting requires Docker with the Compose plugin. Copy .env.example to .env, then run docker compose up -d; the web interface and MCP endpoint are available on localhost:8080. Connect an agent to your instance’s /mcp endpoint and complete authorization. New self-host accounts require administrator approval.
On first startup, the image creates missing secrets and displays the generated administrator password once. Keep data/.secrets.env with the database. Schema validation alone cannot establish that an agent completed its task, so review the actual result separately.
What it helps with
- split agent work into steps with instructions and completion criteria
- resume a workflow run in another agent session
- validate an agent response against a schema
- edit workflows and inspect their runs in the web interface
Example prompts for the agent
- Find a workflow for this task and continue its run.
- Show the available workflows and select one for preparing a report.
- Check whether my response matches this step’s completion schema.
How to install Moira
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Moira
How do I install Moira in Claude Code?
For a self-hosted setup, install Docker with the Compose plugin. Copy .env.example to .env, then run docker compose up -d. Connect Claude Code to your instance’s /mcp endpoint and complete authorization.
What does Moira do?
Moira runs multi-step workflows through MCP. It gives agents instructions and completion criteria, validates submitted response structure, and retains run state for another session.
Which clients does Moira support?
The supported clients listed for Moira include Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, and Zed.
