revibe-mcp

MCP server for Revibe codebase analysis. Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.

Analyze any GitHub repo — get architecture, file roles, execution flows, system design Q&A, and structured agent context.

Quick Start (Node.js — zero install)

Add to your MCP client config:

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

Then ask your AI assistant to "log in to Revibe" — it will open your browser for a one-time signup.

Quick Start (Python)

pip install revibe-mcp
revibe-mcp-auth login

{
  "mcpServers": {
    "revibe": {
      "command": "revibe-mcp"
    }
  }
}

Where to add the config

Client	Config location
Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json`
Claude Code	`.mcp.json` in your project root
Cursor	Settings > MCP Servers > Add
Windsurf	MCP config in settings

Auth

Two options:

Option A: Browser login (recommended)

# Node.js
npx revibe-mcp-auth login

# Python
revibe-mcp-auth login

Opens your browser — sign up or log in, click "Authorize". API key saved automatically to ~/.config/revibe/credentials.json.

Option B: Manual API key

Get a key from app.revibe.codes/settings, then pass it via env:

{
  "mcpServers": {
    "revibe": {
      "command": "npx",
      "args": ["revibe-mcp"],
      "env": {
        "REVIBE_API_KEY": "rk_live_your_key_here"
      }
    }
  }
}

Tools

Tool	Description
`revibe_login`	Log in via browser — one-time setup
`analyze_repo`	Submit a GitHub repo for analysis (auto-detects from git remote)
`check_status`	Check progress of an analysis job
`get_summary`	Architecture, modules, patterns overview
`get_section`	Drill into architecture, file_roles, system_design_qa, etc.
`get_agent_context`	Full structured JSON optimized for AI agents

Usage

Once configured, just ask your AI assistant:

"Analyze this repo with Revibe"
"What's the architecture of github.com/user/repo?"
"Get the agent context for this codebase"

The tools handle auto-detection, polling, and structured output automatically.

CLI Commands

# Node.js
npx revibe-mcp-auth login     # Log in via browser
npx revibe-mcp-auth status    # Show current auth status
npx revibe-mcp-auth logout    # Remove saved credentials

# Python
revibe-mcp-auth login
revibe-mcp-auth status
revibe-mcp-auth logout

Claude Code Skill

If you use Claude Code, you can install Revibe as a slash command skill instead of (or in addition to) the MCP server:

# Copy the skill file
mkdir -p ~/.claude/skills/revibe
curl -o ~/.claude/skills/revibe/SKILL.md \
  https://raw.githubusercontent.com/selvatuple/revibe-mcp/main/skills/claude-code/SKILL.md

Then use /revibe or /revibe github.com/user/repo inside Claude Code.

The skill file is also available at skills/claude-code/SKILL.md.

Packages & Distribution

Method	Install
npm (zero install)	`npx revibe-mcp`
PyPI	`pip install revibe-mcp`
MCP Registry	registry.modelcontextprotocol.io — search "revibe"
Claude Code Skill	Copy `skills/claude-code/SKILL.md` to `~/.claude/skills/revibe/`

License

MIT

revibe mcp