Advertise
MCP.so
Sign In

Vibe Check MCP Server

@PV-Bhat

RepositoryHomepage

Basic information

Category

Other

License

MIT

Transports

stdio

Author

PV-Bhat

About Vibe Check MCP Server

Vibe Check is a tool that provides mentor-like feedback to AI Agents, preventing tunnel-vision, over-engineering and reasoning lock-in for complex and long-horizon agent workflows. KISS your over-eager AI Agents goodbye! Effective for: Coding, Ambiguous Tasks, High-Risk tasks

#automation#mcp#error-handling#agent-based#workflow-automation#ai-agents#metacognition#agentic-workflow#agentic-ai#model-context-protocol#mcp-server#vibe-coding#vibecoding#model-context-protocol-servers

Vibe Check MCP Server config

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

{
  "mcpServers": {
    "vibe-check": {
      "command": "node",
      "args": [
        "/path/to/vibe-check-mcp/build/index.js"
      ],
      "env": {
        "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY"
      }
    }
  }
}

Vibe Check MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Vibe Check MCP?

Vibe Check MCP is a lightweight, plug-and-play oversight server implementing Anthropic’s Model Context Protocol. It acts as an AI meta-mentor for LLM agents, using Chain-Pattern Interrupts (CPI) to prevent reasoning lock-in and keep agents on the minimal viable path. Research shows agents using Vibe Check improved success by 27% and halved harmful actions by 41%.

How to use Vibe Check MCP?

Run directly via npx with npx -y @pv-bhat/vibe-check-mcp start --stdio for MCP clients or --http --port 2091 for manual HTTP inspection. Requires Node >=20. Add the appropriate command block to your MCP client config. Optionally set API keys in a .env file (Gemini, OpenAI, Anthropic, or OpenRouter) and provide a sessionId for history continuity.

Key features of Vibe Check MCP

  • CPI adaptive interrupts that challenge assumptions and keep agents aligned.
  • Multi-provider LLM support: Gemini, OpenAI, Anthropic, and OpenRouter.
  • History continuity: summarizes prior advice when a sessionId is supplied.
  • Optional vibe_learn logs mistakes and fixes for future reflection.
  • Session constitution: enforce per-session rules via update_constitution, reset_constitution, and check_constitution tools.
  • Research-backed with published results; listed in Anthropic’s official MCP repo and MCP Registry.

Use cases of Vibe Check MCP

  • Preventing agents from over-engineering by providing quick sanity checks.
  • Keeping LLMs aligned and reflective before irreversible actions.
  • Reducing harmful agent behaviors in production or experimental workflows.
  • Maintaining consistency across sessions with per-session rule sets.
  • Integrating meta-cognitive feedback into agent system prompts for improved common-sense reasoning.

Frequently asked questions

1

What runtime does Vibe Check MCP require?

Node **>=20** is required. It runs on any platform that supports Node.js.

2

What transport options are available?

STDIO transport for MCP-aware clients (Claude Desktop, Cursor, Windsurf, etc.) and HTTP transport for manual inspection or custom integrations. Default port for HTTP is 2091.

3

Is Vibe Check MCP still actively developed?

The project is in maintenance mode as of the latest release (v2.8.1). Active feature development has ended; only security and bug fix patches are published. Community forks are welcome under the MIT license.

4

Which LLM providers are supported?

Gemini (default), OpenAI, Anthropic, and OpenRouter. Provider is configured via environment variables and can be overridden with `DEFAULT_LLM_PROVIDER`.

5

How do I enforce rules per session?

Use the `update_constitution` tool to set rules for a given `sessionId` (e.g., “no external network calls” or “prefer unit tests before refactors”). Rules are honored by CPI interrupts. Clear them with `reset_constitution` or inspect them with `check_constitution`.

Comments

More Other MCP servers

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K
P

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K
Advertise