Nextjs Cache Handler Mcp

Inspects and operates Next.js Redis caches over local stdio, covering health, tag state, SWR simulation and safe invalidation.

What you can do

Check Redis cache health and list what is cached per layer and kind. Search cache keys by pattern and parse a raw Redis key into layer, kind, namespace and key. Decode a single entry to see its kind, age, tags, TTL, compression and sizes. Query whether a tag is invalidated on both cache layers and simulate whether an entry is fresh, stale or expired on read. Invalidate a tag softly or hard, dry-run by default and only executed with explicit confirmation.

When to use it

Use it when a Next.js deployment runs @leejpsd/nextjs-cache-handler on Redis and you need to find out why a page is not updating, whether a tag is invalidated, or how a cache entry will behave on read.

Requirements

Runs locally as an npm package via npx and needs network access to Redis. REDIS_URL is required; DEPLOYMENT_VERSION is recommended to scope the namespace. CACHE_KEY_PREFIX or ISR_KEY_PREFIX are needed only for custom prefixes, and HASH_TAG for Redis Cluster with hashTag. Redis inside a VPC such as ElastiCache needs an SSH tunnel or bastion.