How do I install Revibe?

Revibe is a local plugin. Install it using npm package: revibe-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Revibe need?

Revibe requires the following credentials or environment variables: REVIBE_API_KEY. You can find setup instructions on the server detail page.

What AI apps work with Revibe?

Revibe uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Revibe MCP Server

by selvatuple

Developer ToolsLow Risk9.8Local

Free

Analyze any codebase — get architecture, file roles, execution flows, and agent context.

About

Analyze any codebase — get architecture, file roles, execution flows, and agent context.

Security Report

9.8

Low Risk9.8Low Risk

Valid MCP server (4 strong, 10 medium validity signals). 2 code issues detected. No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. 2 finding(s) downgraded by scanner intelligence.

8 files analyzed · 3 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Revibe API key (optional — you can also use the revibe_login tool for browser-based auth)Required

Environment variable: REVIBE_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-selvatuple-revibe-mcp": {
      "env": {
        "REVIBE_API_KEY": "your-revibe-api-key-here"
      },
      "args": [
        "-y",
        "revibe-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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/`