{
  "markdown": "# revibe-mcp\n\nMCP server for [Revibe](https://revibe.codes) codebase analysis. Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.\n\nAnalyze any GitHub repo — get architecture, file roles, execution flows, system design Q&A, and structured agent context.\n\n## Quick Start (Node.js — zero install)\n\nAdd to your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"revibe\": {\n      \"command\": \"npx\",\n      \"args\": [\"revibe-mcp\"]\n    }\n  }\n}\n```\n\nThen ask your AI assistant to \"log in to Revibe\" — it will open your browser for a one-time signup.\n\n## Quick Start (Python)\n\n```bash\npip install revibe-mcp\nrevibe-mcp-auth login\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"revibe\": {\n      \"command\": \"revibe-mcp\"\n    }\n  }\n}\n```\n\n## Where to add the config\n\n| Client | Config location |\n|--------|----------------|\n| **Claude Desktop** | `~/Library/Application Support/Claude/claude_desktop_config.json` |\n| **Claude Code** | `.mcp.json` in your project root |\n| **Cursor** | Settings > MCP Servers > Add |\n| **Windsurf** | MCP config in settings |\n\n## Auth\n\nTwo options:\n\n**Option A: Browser login (recommended)**\n```bash\n# Node.js\nnpx revibe-mcp-auth login\n\n# Python\nrevibe-mcp-auth login\n```\nOpens your browser — sign up or log in, click \"Authorize\". API key saved automatically to `~/.config/revibe/credentials.json`.\n\n**Option B: Manual API key**\n\nGet a key from [app.revibe.codes/settings](https://app.revibe.codes/settings), then pass it via env:\n```json\n{\n  \"mcpServers\": {\n    \"revibe\": {\n      \"command\": \"npx\",\n      \"args\": [\"revibe-mcp\"],\n      \"env\": {\n        \"REVIBE_API_KEY\": \"rk_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `revibe_login` | Log in via browser — one-time setup |\n| `analyze_repo` | Submit a GitHub repo for analysis (auto-detects from git remote) |\n| `check_status` | Check progress of an analysis job |\n| `get_summary` | Architecture, modules, patterns overview |\n| `get_section` | Drill into architecture, file_roles, system_design_qa, etc. |\n| `get_agent_context` | Full structured JSON optimized for AI agents |\n\n## Usage\n\nOnce configured, just ask your AI assistant:\n\n- \"Analyze this repo with Revibe\"\n- \"What's the architecture of github.com/user/repo?\"\n- \"Get the agent context for this codebase\"\n\nThe tools handle auto-detection, polling, and structured output automatically.\n\n## CLI Commands\n\n```bash\n# Node.js\nnpx revibe-mcp-auth login     # Log in via browser\nnpx revibe-mcp-auth status    # Show current auth status\nnpx revibe-mcp-auth logout    # Remove saved credentials\n\n# Python\nrevibe-mcp-auth login\nrevibe-mcp-auth status\nrevibe-mcp-auth logout\n```\n\n## Claude Code Skill\n\nIf you use [Claude Code](https://claude.ai/code), you can install Revibe as a slash command skill instead of (or in addition to) the MCP server:\n\n```bash\n# Copy the skill file\nmkdir -p ~/.claude/skills/revibe\ncurl -o ~/.claude/skills/revibe/SKILL.md \\\n  https://raw.githubusercontent.com/selvatuple/revibe-mcp/main/skills/claude-code/SKILL.md\n```\n\nThen use `/revibe` or `/revibe github.com/user/repo` inside Claude Code.\n\nThe skill file is also available at [`skills/claude-code/SKILL.md`](skills/claude-code/SKILL.md).\n\n## Packages & Distribution\n\n| Method | Install |\n|--------|---------|\n| **npm** (zero install) | `npx revibe-mcp` |\n| **PyPI** | `pip install revibe-mcp` |\n| **MCP Registry** | [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io) — search \"revibe\" |\n| **Claude Code Skill** | Copy [`skills/claude-code/SKILL.md`](skills/claude-code/SKILL.md) to `~/.claude/skills/revibe/` |\n\n## License\n\nMIT\n",
  "bytes": 3629,
  "sha": "89c1a29f7659ebc3c5622e5a7bd47120b499457a234dea6a665779bfc92e95ea",
  "repo_slug": "selvatuple/revibe-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_selvatuple_revibe_mcp_92c90650/readme"
}