Make your AI agent follow instructions

Name: MCP Moira
Author: Moira

Stop repeating yourself. Describe the task — your agent picks or builds the right workflow and follows it step by step. Works with Claude Code, Cursor, ChatGPT, and any MCP client.

Get started

View on GitHub

Sound familiar?

"Write the code" → the agent forgets the tests
"Research the topic" → it invents facts and cites nothing
"Write a PRD" → the edge cases are missing
"Write the article" → the structure falls apart halfway
"Generate tests" → only the happy path is covered

So you watch every step: remind, check, repeat.

Moira takes that job off your hands.

You don't need to learn to build workflows

Moira is agent-first: you describe the task, your agent runs the process.

1 Connect your agent Add Moira once to Claude, ChatGPT, Cursor or any other MCP client — it is one server address in the settings. Your tools stay as they are.
2 Describe the task Say what you need in plain words, the way you would tell a colleague.
3 Your agent picks the workflow It runs a ready workflow that fits, or builds one for your task through the Workflow Management Flow — simple or complex, whatever the task needs.

Need a workflow of your own? You don't write it by hand — ask your agent in plain words, for example: "Make me a workflow for reviewing a pull request: security first, then the tests."

Diagrams, variables and editing by hand are optional — they are there when you want to look inside.

What Moira guarantees

One step at a time
The agent sees only the current step and finishes it before the next one. It can't skip ahead.
Checked before moving on
Every step says what the agent must hand back. Moira checks that the answer has all of it and sends it back for a fix until it does.
Nothing forgotten
Tests, docs, commits: the workflow keeps the list even when the agent loses track.
The same result every time
One workflow, one standard of work. No more "it worked yesterday".

What a workflow looks like

Three tiny learning workflows. Each step is the exact instruction your agent receives; Moira checks the answer before the next one.

Example 1: Simple Steps

A straight line: one step at a time, no choices.

1 Step 1
Read the user's request and restate the task in one sentence. If something important is unclear, ask the user before you go on.
2 Step 2
Do the task. Keep to what the user asked for and do not add extra work.
3 Step 3
Compare the result with the request. Fix anything that does not match before you go on.
4 Step 4
Tell the user in a few sentences what you did and how you checked it.

moira/example-simple-steps

Example 2: One Choice

One fork: a yes-or-no answer decides what happens next.

1 Step 1
Do the task the user asked for.
2 Step 2
Check the result against the request. Answer yes if it fully matches, or no if something is missing.
yes — it matches
Step 3 Tell the user in a few sentences what you did.
no — something is missing
Step 4 Tell the user what is missing and why, and suggest what to do next. Do not start the task again in this flow.

moira/example-one-choice

Example 3: Several Paths

Several paths: one answer picks one of three short routes.

1 Step 1
Read the user's request and decide what it is: a question, a bug to fix, or a new idea.
One of
a question
Step 2 Answer the question briefly and say where the answer comes from.
a bug
Step 3 Reproduce the bug, fix it, and show the user that it no longer happens.
an idea
Step 4 Write a short plan for the idea, at most five steps, and ask the user whether to go ahead.

moira/example-several-paths

Try one — say to your agent: "Use Moira to run Example 1: Simple Steps for this task: …"

Walk through all three in the tutorial →

Ready workflows for everyday tasks

Universal workflows for clear tasks with no special logic. Usually your agent picks one for you.

Quick Task

Plans the work, does it with evidence and gets an independent review before handing over the result.

Pick it when a clear, bounded task that is not a code change: a document, research, a set of edits you want checked.

Robust Task

The same idea for long or critical work: retries, recovery after interruptions, replanning when facts change, honest partial results.

Pick it when the task is large or important, or likely to run into problems.

Todo List

Works through a checklist one item at a time — the one you give it, or one it writes once from your goal — with a short proof for each.

Pick it when the steps are clear and just need doing in order.

Software Development Flow

The full change to a code repository: plan → code → tests → docs → review.

Pick it when the task is a feature, a fix or a refactor in code.

Just say: "Use Moira Quick Task for this: …"

Workflows for your role

The catalog also has workflows for specific jobs. A few of them:

Architecture Design Flow

Before the code: requirements, architecture decisions and their documentation, checked by an independent review.

Say: "Use Moira Architecture Design Flow for this service: …"

Test Generation

Writes test code for one target in the project's own test style, runs it and gets it reviewed.

Say: "Use Moira Test Generation for this module: …"

Data Analysis

Works through the data you provide: preparation, methods, conclusions backed by evidence, and their limits.

Say: "Use Moira Data Analysis on this dataset: …"

PRD Creation

A requirements document with priorities, acceptance criteria and risks, checked by an independent reviewer.

Say: "Use Moira PRD Creation for this feature: …"

Content Creation

One text from your brief — structure, draft, sources and final copy — reviewed before delivery.

Say: "Use Moira Content Creation for this brief: …"

A workflow of your own

Three ways to get one — the first is usually enough.

1
Describe it in words
Tell your agent what the workflow should do. It builds it through the Workflow Management Flow.
"Make me a workflow for the weekly report: collect the numbers, write the summary, compare with last week"
2
Start from a ready one
Take a workflow that is close and ask the agent to adapt it.
"Take Quick Task and add a security check before the review"
3
Adjust it by hand (optional)
Open any workflow in the web app and change a step yourself — only if you want to.
Open the workflow and reword one step's instruction

Example conversation

You: I want a release workflow: changelog, version bump, tag, then an announcement.

Agent: Done — I built "Release" with four checked steps: changelog, version, tag, announcement. Shall I run it for the next release?

Built with Moira

Moira is developed with its own Software Development Flow — hundreds of runs on real production code.

PLAN CODE TEST DOCS GIT NOTIFY

Every step checked. Nothing skipped.

See the Software Development Flow →

Stay informed in Telegram

Moira messages you when something needs your attention.

Decision needed

The workflow is waiting for your answer

Step completed

A milestone is reached — see the result

Something went wrong

An error that needs a look

Example notification

MCP Moira Bot

bot

✅ Software Development Flow

Step 4/6 completed: tests passed (42/42)

Just now

No need to keep checking — Moira tells you when it's done.

Run it yourself — Moira is open source

Self-host the engine, the web app and the MCP server in one Docker container under Apache-2.0. Free, single-tenant, and your data stays with you. Rather not run it? Use Moira Cloud.

Self-host on GitHub

Apache-2.0 License

Frequently asked questions

Quick start

Connect MCP Moira in under 2 minutes

Recommended: Use CLI command

Terminal

claude mcp add --transport http moira https://moira-mcp.com/mcp

Then authenticate:

OAuth Flow

# After adding, authenticate within claude
/mcp
# → Select "moira"
# → Click "Authenticate"
# → Browser opens for OAuth

Alternative: Manual JSON config

# Alternative: Manual JSON config
# ~/.config/claude/mcp.json
{
  "mcpServers": {
    "moira": {
      "type": "http",
      "url": "https://moira-mcp.com/mcp"
    }
  }
}

# Then: /mcp → Authenticate

Authentication without OAuth

For CI/CD, Docker, or environments without a browser — use an API token instead of OAuth.

1. Log in to Moira web UI → Settings → API Tokens
2. Create a token (starts with moira_)
3. Replace moira_YOUR_TOKEN below with your token

~/.config/claude/mcp.json

{
  "mcpServers": {
    "moira": {
      "url": "https://moira-mcp.com/mcp",
      "headers": {
        "Authorization": "Bearer moira_YOUR_TOKEN"
      }
    }
  }
}

Recommended: Config file

~/.copilot/mcp-config.json

# ~/.copilot/mcp-config.json
{
  "mcpServers": {
    "moira": {
      "type": "http",
      "url": "https://moira-mcp.com/mcp"
    }
  }
}

Then authenticate:

OAuth Flow

# After saving the config:
# 1. Start a Copilot CLI session
# 2. Type /mcp
# 3. Select "moira" → Authenticate
# → Browser opens for OAuth

Alternative: Interactive setup

# In Copilot CLI:
/mcp
# → Click "Add server"
# → Enter server URL
# → Complete OAuth

# Project-level config:
# .copilot/mcp-config.json (same format)

Authentication without OAuth

For CI/CD, Docker, or environments without a browser — use an API token instead of OAuth.

1. Log in to Moira web UI → Settings → API Tokens
2. Create a token (starts with moira_)
3. Replace moira_YOUR_TOKEN below with your token

~/.copilot/mcp-config.json

{
  "mcpServers": {
    "moira": {
      "type": "http",
      "url": "https://moira-mcp.com/mcp",
      "headers": {
        "Authorization": "Bearer moira_YOUR_TOKEN"
      }
    }
  }
}

Recommended: One-click install

Add to Cursor

Then authenticate:

OAuth Flow

# After clicking the button:
# 1. Cursor opens with install prompt
# 2. Click "Install" to add moira MCP server
# 3. Settings → MCP Servers → Find "moira"
# 4. Click "Authenticate" → Browser opens for OAuth

Alternative: Manual JSON config

~/.cursor/mcp.json

# ~/.cursor/mcp.json
{
  "mcpServers": {
    "moira": {
      "url": "https://moira-mcp.com/mcp"
    }
  }
}

Authentication without OAuth

For CI/CD, Docker, or environments without a browser — use an API token instead of OAuth.

1. Log in to Moira web UI → Settings → API Tokens
2. Create a token (starts with moira_)
3. Replace moira_YOUR_TOKEN below with your token

~/.cursor/mcp.json

{
  "mcpServers": {
    "moira": {
      "url": "https://moira-mcp.com/mcp",
      "headers": {
        "Authorization": "Bearer moira_YOUR_TOKEN"
      }
    }
  }
}

Desktop app: GUI method

Settings → Connectors

# In Claude Desktop app:

# 1. Open Settings (⌘+,)
# 2. Go to "Connectors" tab
# 3. Click "Add custom connector"
# 4. Enter:
#    Server URL: https://moira-mcp.com/mcp
# 5. Click "Connect"
# 6. Browser opens → OAuth → Done

# No file editing

Recommended: One-click install

Add to VS Code

Then authenticate:

OAuth Flow

# After clicking the button:
# 1. VS Code opens with install prompt
# 2. Click "Install" to add moira MCP server
# 3. Settings → MCP Servers → Find "moira"
# 4. Click "Authenticate" → Browser opens for OAuth

Alternative: Manual configuration

settings.json

# Install MCP extension:
# ext install mcp-connector

# Then in settings.json:
{
  "mcp.servers": {
    "moira": {
      "url": "https://moira-mcp.com/mcp",
      "transport": "http"
    }
  }
}

# Or: Command Palette → "MCP: Add Server"

Authentication without OAuth

For CI/CD, Docker, or environments without a browser — use an API token instead of OAuth.

1. Log in to Moira web UI → Settings → API Tokens
2. Create a token (starts with moira_)
3. Replace moira_YOUR_TOKEN below with your token

settings.json

{
  "mcpServers": {
    "moira": {
      "url": "https://moira-mcp.com/mcp",
      "headers": {
        "Authorization": "Bearer moira_YOUR_TOKEN"
      }
    }
  }
}

claude.ai - Browser chat (most popular)

Settings → Connectors

# On claude.ai (Pro/Max/Team/Enterprise):

# 1. Go to Settings → Connectors
# 2. Click "Add custom connector"
# 3. Enter:
#    Server URL: https://moira-mcp.com/mcp
# 4. Click "Connect"
# 5. Complete OAuth authentication in browser
# 6. Tools appear in chat

# Requires paid plan

chat.openai.com - Browser chat

Settings → Connectors

# On chat.openai.com (Plus/Pro required):

# 1. Profile → Settings
# 2. Go to "Connectors" or "Integrations"
# 3. Click "Add connector"
# 4. Enter:
#    Name: MCP Moira
#    URL: https://moira-mcp.com/mcp
# 5. Complete OAuth authentication
# 6. Tools available in chat

# Free tier doesn't support MCP

Mac app: With helper

Settings → Connectors

# Perplexity Mac App:

# 1. Install PerplexityXPC helper first:
#    Settings → Connectors → Install Helper
# 2. Click "Add Connector"
# 3. Enter:
#    Server Name: moira
#    Command: npx
#    Args: -y mcp-remote https://moira-mcp.com/mcp
# 4. Complete OAuth authentication
# 5. Ask Perplexity to use MCP Moira tools

# Paid plan recommended

VS Code extension: Open-source AI assistant

config.yaml

# Continue extension in VS Code:

# 1. Install Continue extension
# 2. Open config: Ctrl+Shift+P → "Continue: Open config"
# 3. Add to config.yaml:
#
# mcp:
#   servers:
#     moira:
#       url: https://moira-mcp.com/mcp
#       transport: http
#
# 4. Restart VS Code
# 5. Authenticate when prompted

Authentication without OAuth

For CI/CD, Docker, or environments without a browser — use an API token instead of OAuth.

1. Log in to Moira web UI → Settings → API Tokens
2. Create a token (starts with moira_)
3. Replace moira_YOUR_TOKEN below with your token

config.yaml

mcpServers:
  - name: moira
    url: "https://moira-mcp.com/mcp"
    headers:
      Authorization: "Bearer moira_YOUR_TOKEN"

Fast code editor with AI features

~/.config/zed/settings.json

# Zed editor:

# 1. Open Settings (⌘+,)
# 2. Add to settings.json under context_servers:
#
# "context_servers": {
#   "moira": {
#     "url": "https://moira-mcp.com/mcp"
#   }
# }
#
# 3. Restart Zed
# 4. Authenticate when prompted

Authentication without OAuth

For CI/CD, Docker, or environments without a browser — use an API token instead of OAuth.

1. Log in to Moira web UI → Settings → API Tokens
2. Create a token (starts with moira_)
3. Replace moira_YOUR_TOKEN below with your token

~/.config/zed/settings.json

{
  "context_servers": {
    "moira": {
      "url": "https://moira-mcp.com/mcp",
      "headers": {
        "Authorization": "Bearer moira_YOUR_TOKEN"
      }
    }
  }
}

Google AI terminal assistant

~/.gemini/settings.json

# Gemini CLI:

# 1. Edit ~/.gemini/settings.json:
#
# "mcpServers": {
#   "moira": {
#     "httpUrl": "https://moira-mcp.com/mcp"
#   }
# }
#
# 2. Run: gemini auth
# 3. Complete OAuth flow

Authentication without OAuth

For CI/CD, Docker, or environments without a browser — use an API token instead of OAuth.

1. Log in to Moira web UI → Settings → API Tokens
2. Create a token (starts with moira_)
3. Replace moira_YOUR_TOKEN below with your token

~/.gemini/settings.json

{
  "mcpServers": {
    "moira": {
      "httpUrl": "https://moira-mcp.com/mcp",
      "headers": {
        "Authorization": "Bearer moira_YOUR_TOKEN"
      }
    }
  }
}

What happens next?

1
Type in your AI chat: "Start user onboarding flow"
2
Your agent walks you through a short interactive onboarding that shows Moira on a real workflow.
3
You see the available workflows and start your first real task.

Ready to try it?

Connect your agent and describe your first task.

Get started

GitHub

Make your AI agent follow instructions

Sound familiar?

You don't need to learn to build workflows

What Moira guarantees

One step at a time

Checked before moving on

Nothing forgotten

The same result every time

What a workflow looks like

Example 1: Simple Steps

Example 2: One Choice

Example 3: Several Paths

Ready workflows for everyday tasks

Quick Task

Robust Task

Todo List

Software Development Flow

Workflows for your role

Architecture Design Flow

Test Generation

Data Analysis

PRD Creation

Content Creation

A workflow of your own

Describe it in words

Start from a ready one

Adjust it by hand (optional)

Example conversation

Built with Moira

Stay informed in Telegram

Decision needed

Step completed

Something went wrong

Example notification

Run it yourself — Moira is open source

Frequently asked questions

Quick start

What happens next?

Ready to try it?

Beta version