VibePilot MCP Server

AI-native project management MCP server for vibe coders. Pilot your projects. Vibe your code.

Features

• 45 MCP Tools — Full project lifecycle: features, sprints, stories, decisions, documents, notes, sessions, releases, dependencies, git integration, and more
• 10 MCP Resources — Project context, feature bundles, sprint data, activity feeds, knowledge graphs
• 8 Persona Prompts — Project manager, technical architect, skeptical reviewer, feature planner, sprint planner, product manager, implementation guide, structured capture
• Dual Transport — stdio (local CLI) + HTTP/SSE (hosted SaaS)
• Dual Database — SQLite (local-first) or PostgreSQL (SaaS via Supabase)
• Session Replay — Every MCP action captured as a replayable trace
• Decision Conflict Detection — Semantic comparison via OpenAI embeddings
• Completeness Scoring — Three-tier quality signals for every entity
• AI Guidance — Per-task structured prompts with three-layer inheritance

Quick Start

Claude Code (stdio)

Add to ~/.claude.json:

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

Claude Desktop

Add to Claude Desktop config:

{
  "mcpServers": {
    "vibepilot": {
      "command": "npx",
      "args": ["vibepilot-mcp"],
      "env": {
        "VIBEPILOT_MODE": "local"
      }
    }
  }
}

Remote (ChatGPT, Cursor, VS Code)

Connect to the hosted MCP endpoint:

https://vibepilot-api.fly.dev/api/mcp

OAuth 2.1 authentication required. Supports ChatGPT, Cursor, VS Code Copilot, and any MCP-compatible client.

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | VIBEPILOT_MODE | local (SQLite) or saas (PostgreSQL) | local | | SUPABASE_DATABASE_URL | PostgreSQL connection string (saas mode) | — | | GEMINI_API_KEY | Google Gemini API key for decision conflict detection (optional) | — |

Tools (45)

Project Management

create_project update_project resolve_project

Features & Stories

create_feature update_feature create_story update_story batch_update_stories

Sprints & Releases

create_sprint update_sprint assign_to_sprint create_release update_release

Decisions & Notes

add_decision supersede_decision add_note

Knowledge Base

create_document update_document add_kb_link get_document_versions restore_document_version

Sessions & Context

start_session log_session_message complete_session start_work_session end_work_session get_active_session save_context_snapshot get_context_snapshot

Quality & Guidance

update_criteria_status add_criterion remove_criterion verify_acceptance_criteria get_ai_guidance get_next_work report_progress

Git Integration

sync_git_commits get_git_status link_commits unlink_commits get_git_feature_stats

Dependencies

add_dependency remove_dependency get_dependency_graph

Utilities

generate_claude_md

Resources (10)

• vibepm://projects — All projects
• vibepm://project/{id}/context — Full project context
• vibepm://project/{id}/features — All features
• vibepm://project/{id}/features/{fid}/bundle — Feature detail bundle
• vibepm://project/{id}/sprints/current — Active sprint
• vibepm://project/{id}/decisions — All decisions
• vibepm://project/{id}/sessions — Brainstorm sessions
• vibepm://project/{id}/activity — Activity feed
• vibepm://project/{id}/documents — Knowledge base documents
• vibepm://project/{id}/releases — Release milestones

License

MIT