agent-guard-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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-mcpClaude 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.jsRelated MCP server: genpark-agent-deadlock-liveloss-loop-detector-skill
Tools
register_agent
Register an agent for monitoring.
Param | Type | Default | Description |
| string | required | Unique agent identifier |
| number | 100 | Max iterations before forced stop |
| 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 |
| string | required | Agent identifier |
| string | required | Tool being called |
| object | required | Arguments passed |
| 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 |
| string | Agent to check |
Returns:
is_stuck— booleanconfidence— 0.0 to 1.0pattern—healthy,exact_repeat,low_diversity, orexact_repeat_and_low_diversitysuggestion— human-readable recovery advicerepeated_actions— list of repeated signatures with counts
set_circuit_breaker
Configure automatic intervention when action patterns repeat.
Param | Type | Default | Description |
| string | required | Agent identifier |
| number | 3 | Trigger after N identical actions |
| string |
|
|
check_circuit_breaker
Pre-flight check before executing a tool. Call this BEFORE the actual tool call.
Param | Type | Description |
| string | Agent identifier |
| string | Tool about to be called |
| 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 |
| 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 |
| 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 recoverTests
npm testLicense
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Catch AI agent loops: halt runs that repeat the same failing step or tool call.
Stops runaway AI agent loops and token burn. Checks each tool call before it runs. No signup.
Recovery loop for agent tool catalogs: measured confusion, ranked fixes, signed recovery receipts.
Autonomous and governed SRE & MLOps control plane for AI agent platforms.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables detection of autonomous agent infinite tool loops, planning deadlocks, and liveloss cycles via trajectory state entropy analysis. Also provides safety guardrails for prompt injection, destructive commands, budget overruns, and data leakage.7MIT
- AlicenseNot gradedqualityBmaintenanceEnables monitoring and interruption of autonomous agent runs by detecting infinite tool loops, livelocks, and planning deadlocks, with safety guardrails for prompt injection, spend limits, and sandboxed command execution.7MIT
- AlicenseNot gradedqualityBmaintenanceEnables users to supervise autonomous AI agent sessions by tailing transcripts, detecting stalls or loops, emitting milestone events for early delivery, querying breaker and subagent telemetry, and tripping the circuit breaker to terminate runaway child processes.MIT
- AlicenseNot gradedqualityBmaintenanceEnables autonomous agents and multi-agent pipelines to protect external API calls with stateful circuit breaking, adaptive exponential backoff with jitter, and fail-fast behavior. It exposes tools to check execution permission, report success or failure, and inspect breaker status and recovery timers.7MIT