1. Conduid
  2. Communication
  3. io.github.mdfifty50-boop/agent-guard
MCP server · Communication

io.github.mdfifty50-boop/agent-guard

· github.com/mdfifty50-boop/agent-guard-mcp

MCP server that detects and prevents infinite agent loops — circuit breakers, pattern detection, and

Unclaimed comms
InstallView source
37Low

Scored 4 months ago · breakdown

About io.github.mdfifty50-boop/agent-guard

io.github.mdfifty50-boop/agent-guard is an MCP server in the Communication category: mCP server that detects and prevents infinite agent loops — circuit breakers, pattern detection, and. It has been installed 0 times through Conduid.

Install

Claude Code
claude mcp add io-github-mdfifty50-boop-agent-guard -- npx -y agent-guard-mcp
npx
npx -y agent-guard-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about io.github.mdfifty50-boop/agent-guard

Powered by Claude · Grounded in docs

I know everything about io.github.mdfifty50-boop/agent-guard. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ·README presentNot checked yet.
  • ·License declaredNot checked yet.
  • ·Tests presentNot checked yet.
  • ·Dependencies pinnedNot checked yet.
  • ·No dynamic code executionNot checked yet.
  • ·Scoped permissionsNot checked yet.

README

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

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

README mirrored from the source repository 4 months ago. The original is authoritative.

Questions

About io.github.mdfifty50-boop/agent-guard

How do I install io.github.mdfifty50-boop/agent-guard?

Run claude mcp add io-github-mdfifty50-boop-agent-guard -- npx -y agent-guard-mcp, then add the server to your MCP client's configuration. Conduid has recorded 0 installs, so the command is known to work with current clients.

Is io.github.mdfifty50-boop/agent-guard safe to use with an AI agent?

Its trust score is 37 out of 100 (low). Conduid hasn't run static security checks on this repository yet, so review the source yourself before granting it credentials. It has no ConduID identity yet, so agent calls to it are not receipted.

Is io.github.mdfifty50-boop/agent-guard still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.