Vibe Check MCP is a plug and play oversight layer for AI agents, built on Anthropic's Model Context Protocol. It interrupts pattern inertia before an agent goes down the wrong path. Think rubber duck debugging, but the duck talks back.

It crossed 70k+ downloads and ~500 GitHub stars, got listed in Anthropic's official MCP repo, and landed on PulseMCP's "Most Popular" front page in October 2025. Not bad for a sanity checker.

the problem: pattern inertia

LLM agents can confidently follow flawed plans. Once a reasoning path locks in, they will happily build a full parsing engine to read ten rows of CSV. I call this Reasoning Lock-In (RLI), and it gets worse the longer a task runs. Without an external nudge, agents spiral into over-engineering and drift away from what you actually asked for.

the fix: chain-pattern interrupts

Vibe Check pairs a metacognitive signal layer with CPI (Chain-Pattern Interrupt), the research method behind the tool. A second LLM watches the agent's plan, surfaces uncertainty and risk, and injects brief, well-timed pause points at risk inflection moments to re-align the agent with the user's true priority.

In pooled evaluation across 153 runs, CPI nearly doubled success (27% to 54%) and roughly halved harmful actions (83% to 42%). The optimal interrupt dosage is about 10 to 20% of steps. The paper is on ResearchGate and the reference implementation lives at github.com/PV-Bhat/cpi.

what's in the box

  • vibe_check: challenges assumptions and prevents tunnel vision before irreversible actions
  • vibe_learn: logs mistakes, preferences and successes for future reflection
  • session constitutions: per-session rules the CPI layer enforces, like "no external network calls" or "prefer unit tests before refactors" (update, reset and check tools included)
  • multi-provider support: Gemini, OpenAI, Anthropic and OpenRouter, over STDIO or streamable HTTP

quickstart

npx -y @pv-bhat/vibe-check-mcp start --stdio

Point any MCP-aware client at it (Claude Desktop, Cursor, Windsurf, VS Code) and tell your agent to call vibe_check after planning and before major actions. That one system prompt line does a lot of heavy lifting.

status

v2.8.0 is the final release: security patches, bug fixes, and the latest MCP SDK. The project is no longer actively maintained, but the server remains fully functional and community forks are welcome under MIT. It was a fun ride.