nicofains1 avatar

AgentWatch

nicofains1/agentwatch

Gives you post-mortem tools for multi-agent systems. Agents call `report()` for heartbeats and `trace()` for actions, linking them by trace ID and parent event. When something fails, `correlate()` walks backward through the chain to find the root cause. Exposes 13 MCP tools including `agentwatch_cascade`, `agentwatch_replay`, and `agentwatch_dashboard` so Claude can diagnose why your swarm fell over. Stores everything in local SQLite, works with any agent framework. The CLI lets you run `npx @nicofains1/agentwatch demo` to see a 5-agent cascade failure traced soup to nuts. Useful if you're running CrewAI, AutoGen, or custom agents and need forensics when one failure triggers three others.

tools
13
transport
STDIO
env var
1
last updated
Mar 16, 2026

Tools

13 tools

Public tool metadata for what this MCP can expose to an agent.

agentwatch_dashboardFleet health overview.

Fleet health overview.

No parameter schema in public metadata yet.

agentwatch_report_heartbeat

No parameter schema in public metadata yet.

agentwatch_trace

No parameter schema in public metadata yet.

agentwatch_cascade

No parameter schema in public metadata yet.

agentwatch_replay

No parameter schema in public metadata yet.

agentwatch_get_alerts

No parameter schema in public metadata yet.

agentwatch_get_failures

No parameter schema in public metadata yet.

agentwatch_get_trace

No parameter schema in public metadata yet.

agentwatch_fleet_health

No parameter schema in public metadata yet.

agentwatch_create_trace_id

No parameter schema in public metadata yet.

agentwatch_alert

No parameter schema in public metadata yet.

agentwatch_resolve_alert

No parameter schema in public metadata yet.

agentwatch_dashboard_text

No parameter schema in public metadata yet.

Sponsors

Configuration

AGENTWATCH_DB

Path to SQLite database file

Readme

agentwatch

Your agent swarm crashed at 2am. You have logs from 10 agents and no idea which one started the cascade. AgentWatch tells you.

It tracks heartbeats, links actions across agents, walks backward from any failure to the root cause, and replays the full sequence. Works with any agent framework (CrewAI, AutoGen, LangGraph, PocketFlow, custom). Stores everything in a local SQLite file.

Early stage. Issues and feedback welcome: https://github.com/nicofains1/agentwatch/issues


See it in action

No install needed:

npx @nicofains1/agentwatch demo

This seeds a 5-agent fleet, triggers a cascade failure, and shows you the full trace:

AgentWatch Fleet Dashboard
============================================================
Agents: 5 total | 3 healthy | 1 degraded | 1 error | 0 offline

View the full README on GitHub

Details

Repository
github.com/nicofains1/agentwatch
Categories
AI & LLM Tools, Monitoring & Observability
Package
@nicofains1/agentwatch
Transport
STDIO
Registry
MCP registry, active

More from nicofains1

Related AI & LLM Tools MCP servers

View all
1deadpixel avatarRoundtabledeadpixel/roundtable-dashboardMulti-model AI debates: GPT-4o, Claude, Gemini & 200+ models discuss, then synthesize insight.0stars
2pree-dew avatarMcp Bookmarkpree-dew/mcp-bookmarkMCP Server for adding bookmarks in openai RAG0stars
3psyseal avatarPsyseal scanpsyseal/psyseal-scanOffline check of your AI agent: heartbeat cost, plaintext keys, planted or bloated memory.0stars
4robinhood avatarRobinhood (Agentic Trading)robinhoodOfficial Robinhood MCP server for agentic trading. Connect any AI agent to a dedicated, sandboxed Agentic account: it can read your accounts, positions, and ord0stars
5robotfleet-hq avatarSecurity Orchestrarobotfleet-hq/security-orchestraMulti-agent MCP platform for data centers and critical power.0stars
6rocnubie avatarBest AI Image Prompt MCProcnubie/bestaiimageprompt-mcpThe best AI image prompt library online. Latest trending prompts copy & paste for GPT image 2,0stars