mcp-graph-loop
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-graph-loopSet up a task DAG for my project and run validation loops until all tasks pass."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
BRD Graph Loop MCP Server
A specialized MCP (Model Context Protocol) server for graph-based task orchestration with automated validation and self-healing retry loops.
🎯 How It Works: High-Level Architecture
flowchart TD
subgraph AI["🤖 AI Agent (Claude / Cursor / IDE)"]
A1[1. Initialize Graph] --> A2[2. Query Ready Tasks]
A2 --> A3[3. Start Task & Write Code]
A3 --> A4[4. Call validate_task_loop]
end
subgraph MCP["⚙️ BRD Graph Loop MCP Server"]
M1[(State Management: nodes, dependencies, status)]
M2[Dependency Resolver & DAG Engine]
M3[Command Executor & Output Capture]
M4[Loop Controller: Retries, Max Attempts, Error Logging]
end
A1 -->|init_project_graph| M1
A2 -->|get_ready_tasks| M2
A3 -->|start_task| M1
A4 -->|validate_task_loop| M3
M3 -->|Pass: exitCode 0| M4
M3 -->|Fail: exitCode != 0| M4
M4 -->|Unlock Next Tasks| M2
M4 -->|Return Error Context| AIRelated MCP server: Bernstein - Multi-agent orchestration
🔄 Node Lifecycle & State Transitions
Each task node moves through deterministic states based on its prerequisites and validation results:
stateDiagram-v2
[*] --> PENDING : Initial state with unresolved dependencies
PENDING --> READY : All 'depends_on' tasks reach COMPLETED
READY --> IN_PROGRESS : AI calls 'start_task'
state "Validation Loop" as Loop {
IN_PROGRESS --> VALIDATING : AI calls 'validate_task_loop'
VALIDATING --> RETRYING : Command fails (exitCode != 0 & attempts < max)
RETRYING --> IN_PROGRESS : AI reads error logs and fixes code
}
VALIDATING --> COMPLETED : Command passes (exitCode 0)
VALIDATING --> FAILED : Command fails & max_attempts exceeded
COMPLETED --> [*] : Unlocks downstream PENDING nodes
FAILED --> [*] : Can be reset with 'reset_task_node'💡 Key Concepts
1. Directed Acyclic Graph (DAG)
Tasks have explicit dependencies (depends_on: ["task_a", "task_b"]). The server automatically ensures tasks only become READY when all their prerequisite tasks are COMPLETED.
2. The Iterative Validation Loop
Instead of hoping code works, each node specifies a validation_command (e.g., npm test, tsc --noEmit, pytest, eslint):
Pass (
exitCode: 0): Loop status becomesPASSED, node becomesCOMPLETED, and dependent nodes automatically switch toREADY.Fail (
exitCode != 0): The server logs fullstdout/stderrand exit codes inerror_logs, incrementscurrent_attempt, and returns the error output to the AI.Self-Correction: The AI analyzes the error, modifies code, and calls
validate_task_loopagain until it passes or hitsmax_attempts.
🛠️ Complete Step-by-Step Flow
Step 0: Scaffold Project Planning Docs (scaffold_project_docs)
Before initializing the graph, the AI agent can generate standard project documentation (Architecture, Phase-wise Tasks, and Test Cases) based on the user's requirements:
{
"targetDirectory": "./",
"architectureContent": "# Project Architecture\n...",
"phaseTasks": [
{ "fileName": "PHASE_1.md", "content": "# Phase 1 Tasks\n..." }
],
"testCasesContent": "# Integration Tests\n..."
}Step 1: Initialize Workflow (init_project_graph)
The AI agent creates a task graph for a project:
{
"projectName": "Auth Feature",
"projectRoot": "/path/to/your/project/dir",
"nodes": [
{
"id": "schema",
"title": "Define User Database Schema",
"description": "Create Prisma schema and migration scripts",
"depends_on": [],
"validation_command": "npx prisma validate",
"max_attempts": 3
},
{
"id": "jwt_service",
"title": "Build JWT Token Service",
"description": "Implement sign, verify, and refresh token functions",
"depends_on": ["schema"],
"validation_command": "npm run test -- jwt.test.ts",
"max_attempts": 3
},
{
"id": "login_route",
"title": "Build API Login Endpoint",
"description": "Express POST /api/login endpoint with validation",
"depends_on": ["jwt_service"],
"validation_command": "npm run test -- auth.test.ts",
"max_attempts": 3
}
]
}Step 2: Fetch Ready Tasks (get_ready_tasks)
The agent asks what to work on next:
{
"ready_count": 1,
"ready_tasks": [
{
"id": "schema",
"title": "Define User Database Schema",
"status": "READY"
}
]
}(Notice jwt_service and login_route remain PENDING because their dependencies aren't done yet).
Step 3: Start the Task (start_task)
The agent claims the task:
{ "nodeId": "schema" }Node status transitions to IN_PROGRESS.
Step 4: Validate the Code (validate_task_loop)
After the agent writes the schema files, it triggers the validation loop:
{ "nodeId": "schema" }If it passes:
schemastatus becomesCOMPLETED.jwt_serviceautomatically becomesREADY!
If it fails:
MCP returns:
{ "validation_passed": false, "message": "Validation failed on attempt 1/3. Node 'schema' is in RETRYING status.", "result": { "exitCode": 1, "error": "Syntax error at line 14: invalid relation syntax" } }The AI reviews the error, fixes line 14, and re-calls
validate_task_loop.
📦 MCP Configuration
Add this to your MCP settings file (~/.cursor/mcp.json, Claude Desktop config, or .gemini/config/mcp_config.json):
{
"mcpServers": {
"brd-graph-loop": {
"command": "node",
"args": [
"/Volumes/DATA/html work/mcp-graph-loop-server/build/index.js"
]
}
}
}Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityDmaintenanceA task orchestration system for AI agent teams that provides a Kanban dashboard and 12 MCP tools to manage multi-step workflows with DAG dependencies. It enables agents to coordinate through task threads, automated retries, and real-time webhook notifications.27MIT
- AlicenseAqualityAmaintenanceOrchestrates multiple AI coding agents declaratively to automate software development workflows for engineering teams.212848Apache 2.0
- Alicense-qualityBmaintenanceEnables AI coding agents to execute formal, stateful workflows with typed contracts, postcondition enforcement, and structured retry logic.1Apache 2.0
- -license-quality-maintenanceEnables local task planning and execution with DAG-based plans, multiple reasoning methods, and persistence for AI agents.
Related MCP Connectors
Build, validate, and deploy multi-agent AI solutions from any AI environment.
Verifies AI agent work end to end: real artifacts and outcomes checked, not self-reported success.
Durable agent-to-agent handoffs and shared scratchpad for multi-agent workflows.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/denishmistry07/mcp-graph-loop'
If you have feedback or need assistance with the MCP directory API, please join our Discord server