Skip to main content
Glama
ralph-loop-mcp

ralph-loop-mcp

ralph-wiggum-loop

Multi-model iterative development agent plugin — Ralph Loop with cross-model worker/reviewer architecture and SHIP/REVISE decision engine.

License: MIT Agent Plugin GitHub Pages

Overview

The Ralph Loop implements a two-phase iterative workflow where a worker model does the work and a reviewer model provides cross-model review, iterating until the reviewer says "SHIP".

This project is a cross-platform Agent Plugin that provides both:

  • MCP Server Mode — 11 tools over stdio for integration with AI agents

  • CLI Mode — Run the full loop directly from the command line

Related MCP server: AMS Development MCP Servers

Quick Start

CLI Mode

./bin/ralph-loop-runner.sh "Implement user authentication with JWT tokens"

MCP Server Mode

# Run without arguments to start the MCP server
./bin/ralph-loop-runner.sh

With a Quality Profile

./bin/ralph-loop-runner.sh "Write a REST API" --profile pro

Documentation

Repository

License

MIT

Available Tools

10 tools
ralph_loop_blockA

Block the current iteration with a reason (creates RALPH-BLOCKED.md). Worker uses this when stuck.

Inputs: reason (required), sessionId.

ralph_loop_get_configB

Get the worker/reviewer model configuration for the session.

Inputs: sessionId.

ralph_loop_get_feedbackB

Get reviewer feedback for the next worker iteration. Returns feedback if REVISE, or completion status if SHIP.

Inputs: sessionId.

ralph_loop_get_statusA

Get current status of the Ralph Loop session including iteration, phase, and state.

Inputs: sessionId.

ralph_loop_get_taskC

Get the current task for the worker phase. Returns the task description.

Inputs: sessionId.

ralph_loop_get_workB

Get the worker's submitted work for the reviewer phase. Returns work output and summary.

Inputs: sessionId.

ralph_loop_initializeB

Initialize a new Ralph Loop session with a task. Starts the iterative worker/reviewer cycle.

Inputs: task (required), sessionId, workerModel, maxIterations, +4 more.

ralph_loop_resetA

Reset/clear a Ralph Loop session, removing all state files.

Inputs: sessionId.

ralph_loop_submit_reviewB

Submit review decision (SHIP or REVISE) with feedback from the reviewer phase.

Inputs: decision (required), iteration (required), feedback, sessionId.

ralph_loop_submit_workA

Submit work results and summary from the worker phase. Transitions to review phase.

Inputs: work (required), summary (required), iteration (required), sessionId.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool has a distinct purpose: initialization, work submission, review feedback, status, etc. No two tools have overlapping functionality.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with the ralph_loop_ prefix in snake_case, making them predictable and logical.

    Tool Count5/5

    With 10 tools, the set covers the full worker/reviewer cycle without being bloated or insufficient.

    Completeness4/5

    Covers all major phases: initialize, work, review, block, reset, and status. Minor gap: no explicit tool to list all feedback history, but core workflow is complete.

    Maintenance

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      An MCP server that turns independent AI agents into a coordinated engineering team with shared task board, context, review loop, and enforced plan-implement-review-iterate workflow.
      24
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for creating, validating, and reviewing implementation plans in GitHub Copilot Chat, with visual review interface and MongoDB persistence.
      MIT