Skip to main content
Glama
mdfifty50-boop

agent-guard-mcp

by mdfifty50-boop
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

agent-guard-mcp

MCP server that detects and prevents infinite agent loops — the #1 reliability problem in agentic systems.

Provides circuit breakers, pattern detection, stuck-agent analysis, and recovery recommendations via the Model Context Protocol.

Install

npx agent-guard-mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "agent-guard": {
      "command": "npx",
      "args": ["agent-guard-mcp"]
    }
  }
}

From source

git clone https://github.com/mdfifty50-boop/agent-guard-mcp.git
cd agent-guard-mcp
npm install
node src/index.js

Related MCP server: Unloop MCP

Tools

register_agent

Register an agent for monitoring.

Param

Type

Default

Description

agent_id

string

required

Unique agent identifier

max_iterations

number

100

Max iterations before forced stop

progress_threshold

number

0.3

Min unique/total action ratio to be "making progress"

log_action

Log an agent action for loop detection. Maintains a rolling window of the last 50 actions.

Param

Type

Default

Description

agent_id

string

required

Agent identifier

tool_name

string

required

Tool being called

args

object

required

Arguments passed

result_preview

string

""

Brief result preview (max 200 chars)

Returns early warnings when repeated patterns are detected.

detect_loop

Check if an agent is stuck in an infinite loop.

Param

Type

Description

agent_id

string

Agent to check

Returns:

  • is_stuck — boolean

  • confidence — 0.0 to 1.0

  • pattern — healthy, exact_repeat, low_diversity, or exact_repeat_and_low_diversity

  • suggestion — human-readable recovery advice

  • repeated_actions — list of repeated signatures with counts

set_circuit_breaker

Configure automatic intervention when action patterns repeat.

Param

Type

Default

Description

agent_id

string

required

Agent identifier

max_repeats

number

3

Trigger after N identical actions

action

string

"warn"

"warn", "block", or "suggest_alternative"

check_circuit_breaker

Pre-flight check before executing a tool. Call this BEFORE the actual tool call.

Param

Type

Description

agent_id

string

Agent identifier

proposed_tool

string

Tool about to be called

proposed_args

object

Arguments about to be passed

Returns proceed: false when the circuit breaker fires (block mode only).

get_stuck_report

Detailed analysis of why an agent is stuck.

Param

Type

Description

agent_id

string

Agent to analyze

Returns: action history, pattern analysis, token waste estimate, diversity ratio, top repeated patterns, and recovery recommendations.

get_health_dashboard

Overview of all monitored agents. No parameters.

Returns all agents sorted by risk score with their status (STUCK/HEALTHY), action counts, and circuit breaker config.

Resources

URI

Description

agent-guard://agents

All monitored agents with current status

Usage Pattern

1. register_agent — at agent startup
2. Before each tool call:
   a. check_circuit_breaker — should this action proceed?
   b. Execute the tool
   c. log_action — record what happened
3. Periodically:
   - detect_loop — am I stuck?
   - get_health_dashboard — how are all agents doing?
4. On stuck detection:
   - get_stuck_report — what went wrong and how to recover

Tests

npm test

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • MCP Dual-Cycle Reasoner

    cyqlelabs
    A
    license
    A
    quality
    B
    maintenance
    A Model Context Protocol server that empowers AI agents with metacognitive monitoring to detect reasoning loops and provide intelligent recovery using case-based reasoning and statistical analysis.
    9
    50 npm
    9
    MIT

  • Unloop MCP

    synthet1cc
    A
    license
    Not graded
    quality
    D
    maintenance
    Detects and breaks repetitive fix loops in AI coding assistants by tracking attempts and providing escalating intervention strategies. It utilizes error fingerprinting and similarity analysis to redirect the AI toward new approaches when it gets stuck on the same error.
    4 npm
    4
    MIT

  • Agentguard47

    bmdhodl
    A
    license
    A
    quality
    A
    maintenance
    AgentGuard47 is runtime safety infrastructure for AI agents. It adds budget caps, loop detection, retry limits, timeouts, local traces, and incident reports so agents can stop bad runs while they are happening, not just explain them afterward.
    7
    4
    MIT

  • looplens-mcp

    musaceylan
    A
    license
    B
    quality
    D
    maintenance
    An MCP server for detecting retry loops and analyzing iteration patterns in agentic coding workflows, providing structured debugging intelligence to improve repair attempts.
    16
    4
    MIT