English Français العربية

io.github.selvatuple/revibe-mcp

Official registry AI and agents

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package revibe-mcp
Claude Code 
claude mcp add revibe-mcp -e 'REVIBE_API_KEY=<your revibe_api_key>' -- npx -y revibe-mcp@0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "revibe-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "revibe-mcp@0.1.1"
            ],
            "env": {
                "REVIBE_API_KEY": "<your revibe_api_key>"
            }
        }
    }
}

Environment variables

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

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. revibe-mcp
  2. Quick Start (Node.js — zero install)
  3. Quick Start (Python)
  4. Where to add the config
  5. Auth
  6. Tools
  7. Usage
  8. CLI Commands
  9. Claude Code Skill
  10. Packages & Distribution
  11. License

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

ClientConfig location
Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.json
Claude Code.mcp.json in your project root
CursorSettings > MCP Servers > Add
WindsurfMCP 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

ToolDescription
revibe_loginLog in via browser — one-time setup
analyze_repoSubmit a GitHub repo for analysis (auto-detects from git remote)
check_statusCheck progress of an analysis job
get_summaryArchitecture, modules, patterns overview
get_sectionDrill into architecture, file_roles, system_design_qa, etc.
get_agent_contextFull 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

MethodInstall
npm (zero install)npx revibe-mcp
PyPIpip install revibe-mcp
MCP Registryregistry.modelcontextprotocol.io — search "revibe"
Claude Code SkillCopy skills/claude-code/SKILL.md to ~/.claude/skills/revibe/

License

MIT

Frequently asked questions

What is io.github.selvatuple/revibe-mcp?

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

How do I install io.github.selvatuple/revibe-mcp?

It runs on your machine. In Claude Code: claude mcp add revibe-mcp -e 'REVIBE_API_KEY=<your revibe_api_key>' -- npx -y revibe-mcp@0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.selvatuple/revibe-mcp need an API key?

Yes. It expects REVIBE_API_KEY, which you set in its configuration.

Is io.github.selvatuple/revibe-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.selvatuple/revibe-mcp?

It is published by selvatuple. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.