$git clone https://github.com/PV-Bhat/vibe-check-mcp-server> This project is in maintenance mode. Active feature development has ended; only maintenance patches (security and bug fixes) are published. v2.8.1 is the latest maintenance release. The server remains fully functional. Community forks and contributions are welcome under the
| 1 | # Vibe Check MCP |
| 2 | |
| 3 | > **This project is in maintenance mode.** Active feature development has ended; only maintenance patches (security and bug fixes) are published. v2.8.1 is the latest maintenance release. The server remains fully functional. Community forks and contributions are welcome under the MIT license. |
| 4 | |
| 5 | <p align="center"><b>KISS overzealous agents goodbye. Plug & play agent oversight tool.</b></p> |
| 6 | |
| 7 | <p align="center"> |
| 8 | <b>Based on research:</b><br/> |
| 9 | In our study agents calling Vibe Check improved success +27% and halved harmful actions -41% |
| 10 | </p> |
| 11 | |
| 12 | <p align="center"> |
| 13 | <a href="https://www.researchgate.net/publication/394946231_Do_AI_Agents_Need_Mentors_Evaluating_Chain-Pattern_Interrupt_CPI_for_Oversight_and_Reliability?channel=doi&linkId=68ad6178ca495d76982ff192&showFulltext=true"> |
| 14 | <img src="https://img.shields.io/badge/Research-CPI%20%28MURST%29-blue?style=flat-square" alt="CPI Research"> |
| 15 | </a> |
| 16 | <a href="https://github.com/modelcontextprotocol/servers"><img src="https://img.shields.io/badge/Anthropic%20MCP-featured-111?labelColor=111&color=555&style=flat-square" alt="Anthropic MCP: listed"></a> |
| 17 | <a href="https://registry.modelcontextprotocol.io/"><img src="https://img.shields.io/badge/MCP%20Registry-listed-555?labelColor=111&style=flat-square" alt="MCP Registry"></a> |
| 18 | <a href="https://www.pulsemcp.com/servers/pv-bhat-vibe-check"> |
| 19 | <img src="https://img.shields.io/badge/PulseMCP-Most%20Popular%20(Oct 2025)-0b7285?style=flat-square" alt="PulseMCP: Most Popular (this week)"> |
| 20 | </a> |
| 21 | <a href="https://github.com/PV-Bhat/vibe-check-mcp-server/actions/workflows/ci.yml"><img src="https://github.com/PV-Bhat/vibe-check-mcp-server/actions/workflows/ci.yml/badge.svg" alt="CI passing"></a> |
| 22 | <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-0b7285?style=flat-square" alt="MIT License"></a> |
| 23 | </p> |
| 24 | |
| 25 | <p align="center"> |
| 26 | <sub> Featured on PulseMCP “Most Popular (This Week)” • 5k+ monthly calls on Smithery.ai • research-backed oversight • STDIO + streamable HTTP transport</sub> |
| 27 | </p> |
| 28 | |
| 29 | <img width="500" height="300" alt="Gemini_Generated_Image_kvdvp4kvdvp4kvdv" src="https://github.com/user-attachments/assets/ff4d9efa-2142-436d-b1df-2a711a28c34e" /> |
| 30 | |
| 31 | [](https://github.com/PV-Bhat/vibe-check-mcp-server) |
| 32 | [](https://archestra.ai/mcp-catalog/pv-bhat__vibe-check-mcp-server) |
| 33 | [](CONTRIBUTING.md) |
| 34 | |
| 35 | *Plug-and-play mentor layer that stops agents from over-engineering and keeps them on the minimal viable path — research-backed MCP server keeping LLMs aligned, reflective and safe.* |
| 36 | |
| 37 | <div align="center"> |
| 38 | <a href="https://github.com/PV-Bhat/vibe-check-mcp-server"> |
| 39 | <img src="https://unpkg.com/@lobehub/icons-static-svg@latest/icons/github.svg" width="40" height="40" alt="GitHub" /> |
| 40 | </a> |
| 41 | |
| 42 | <a href="https://registry.modelcontextprotocol.io"> |
| 43 | <img src="https://unpkg.com/@lobehub/icons-static-svg@latest/icons/anthropic.svg" width="40" height="40" alt="Anthropic MCP Registry" /> |
| 44 | </a> |
| 45 | |
| 46 | <a href="https://smithery.ai/server/@PV-Bhat/vibe-check-mcp-server"> |
| 47 | <img src="https://unpkg.com/@lobehub/icons-static-svg@latest/icons/smithery.svg" width="40" height="40" alt="Smithery" /> |
| 48 | </a> |
| 49 | |
| 50 | <a href="https://www.pulsemcp.com/servers/pv-bhat-vibe-check"> |
| 51 | <img src="https://www.pulsemcp.com/favicon.ico" width="40" height="40" alt="PulseMCP" /> |
| 52 | </a> |
| 53 | </div> |
| 54 | |
| 55 | <div align="center"> |
| 56 | <em>Trusted by developers across MCP platforms and registries</em> |
| 57 | </div> |
| 58 | |
| 59 | ## Quickstart (npx) |
| 60 | |
| 61 | Run the server directly from npm without a local installation. Requires Node **>=20**. Choose a transport: |
| 62 | |
| 63 | ### Option 1 – MCP client over STDIO |
| 64 | |
| 65 | ```bash |
| 66 | npx -y @pv-bhat/vibe-check-mcp start --stdio |
| 67 | ``` |
| 68 | |
| 69 | - Launch from an MCP-aware client (Claude Desktop, Cursor, Windsurf, etc.). |
| 70 | - `[MCP] |