VibeCheck MCP Server

Expose VibeCheck's pre-launch auditing as MCP tools inside Claude Desktop, Cursor, or Claude Code.

Tools

| Tool | Description | |---|---| | vibecheck_audit | Full audit — all categories, ~3–6 min | | vibecheck_quick_check | Single-category audit, ~90 seconds | | vibecheck_explain | Explain a specific check ID with fix guidance | | vibecheck_fix_prompt | Generate a ready-to-paste fix prompt for failing checks | | vibecheck_leaderboard | Most commonly failing checks across all audits |

Usage

# One-shot audit from your AI assistant
vibecheck_audit({ url: "https://staging.yourapp.com" })

# Check just auth before merging
vibecheck_quick_check({ url: "https://staging.yourapp.com", category: "auth" })

# Generate a fix prompt for all failures
vibecheck_fix_prompt({ audit_id: "clx...", stack_hint: "Next.js 14, Supabase, Vercel" })

# Find the most common pre-launch mistakes
vibecheck_leaderboard({ limit: 10, min_audits: 5 })

Claude Desktop Setup

Add this to your ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "vibecheck": {
      "command": "npx",
      "args": ["vibecheck-launch-mcp"]
    }
  }
}

Cursor / Claude Code Setup

Add the same block to your .cursor/mcp.json or .claude/mcp.json project config.

Build

cd mcp
npm install
npm run build

The compiled server lives at mcp/dist/index.js.

Environment Variables

| Variable | Default | Description | |---|---|---| | VIBECHECK_API_URL | https://vibecheck.builtthisweekend.com | Override to point at a local or staging instance |