Context Rot Detection MCP Server

@milos-product-maker

Basic information

About Context Rot Detection MCP Server

Context Rot Detection & Healing — gives AI agents self-awareness about their cognitive state by analyzing token utilization, quality degradation, and session fatigue. Returns health scores (0-100), model-specific degradation curves for 15+ models, lost-in-the-middle risk scoring,

#mcp#context-rot#ai-agents #context-window#agent-health#llm #context-engineering #model-context-protocol

Context Rot Detection MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "context-rot-detection": {
      "command": "npx",
      "args": [
        "-y",
        "context-rot-detection"
      ],
      "env": {
        "HEALTH_HISTORY_DB": "./health.db"
      }
    }
  }
}

Context Rot Detection MCP Server tools

Analyze your current context window health. Returns a health score (0-100), token utilization, estimated quality degradation, and recommendations for recovery. Call this periodically during long sessions or before critical decisions.

Retrieve health check history for an agent. Requires agent_id. Returns recent health checks and aggregate statistics.

Get service-wide utilization statistics: total calls, unique agents, model distribution, health score averages, and recent activity. Useful for operators monitoring service adoption and usage patterns.

Overview

What is Context Rot Detection?

Context Rot Detection is an MCP service that gives AI agents real-time visibility into their own cognitive health. It measures performance degradation as the context window fills up, providing a health score (0–100) based on token utilization, retrieval accuracy, and session fatigue. It is designed for developers building long-running production agent systems.

How to use Context Rot Detection?

Install via npx (zero install) or npm global install. Configure as an MCP client tool for Claude Code or Claude Desktop, or run with Docker. Use the check_my_health tool periodically to analyze the current context window health, passing required token count and optional parameters.

Key features of Context Rot Detection

Health score (0–100) based on token utilization, retrieval accuracy, and session fatigue
Model-specific degradation curves for 15+ curated models (Claude, GPT, Gemini, o-series)
Auto-resolves any HuggingFace model, caching context window in SQLite
Lost-in-the-middle risk scoring based on Stanford research
Actionable recovery recommendations (compact context, offload, checkpoint)
Per-agent health history tracking and service-wide utilization statistics

Use cases of Context Rot Detection

Monitoring real-time cognitive health of long-running AI agents
Detecting context rot before critical decisions or actions
Analyzing per-agent health trends and service-wide degradation patterns
Providing actionable recommendations to mitigate quality loss

Frequently asked questions

What signals make up the health score?

The health score is a weighted composite of token utilization quality (40%), retrieval accuracy (25%), tool-call burden (20%), and session length (15%).

How are model-specific degradation curves determined?

Curves are derived from empirical research (Chroma, Stanford, Redis) and are provided for 15+ curated models. Any HuggingFace model can be auto-resolved by fetching its config.json to extract context window size.

What data is stored and where?

Health history is stored in a SQLite database configured via the `HEALTH_HISTORY_DB` environment variable (defaults to `:memory:`). The server caches HuggingFace model lookups in the same database.

Does the server require network access?

Yes, for HuggingFace model auto-resolution it fetches `config.json` from the HuggingFace repo. If that fails, it falls back to conservative defaults. Local model detection does not require network.

What transports and authentication are supported?

The server uses stdio transport (standard MCP). There is no built-in authentication; it is intended to be invoked by MCP clients like Claude Desktop or Claude Code.

Comments

More Other MCP servers

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40