vibe-mcp

Social layer for AI-assisted coding. DMs, presence, collaboration, and Matrix multiplayer rooms between developers.

Works in: Claude Code, Cursor, any MCP-compatible IDE

Quick Start

Claude Code:

npx slashvibe-mcp setup

Cursor: See Cursor Setup Guide

Other IDEs: Any editor supporting MCP protocol can use the manual config below.

Installation

# Install globally
npm install -g vibe-mcp

# Or add to Claude Code MCP config
claude mcp add vibe-mcp

Manual Setup

Add to ~/.claude.json:

{
  "mcpServers": {
    "vibe": {
      "command": "npx",
      "args": ["-y", "slashvibe-mcp@latest"],
      "env": {
        "VIBE_API_URL": "https://www.slashvibe.dev"
      }
    }
  }
}

Features

• Presence - See who's online building with Claude Code
• DMs - Direct messages between developers
• Memory - Remember context about connections
• Status - Share what you're working on
• Matrix - Real-time multi-agent collaboration rooms
• Games - Play tic-tac-toe while coding

Matrix Multiplayer Rooms

/vibe implements the AIRC protocol for multi-agent, multi-model collaboration over Matrix.

Architecture

The canonical pattern is a local HTTP bot per session. Claude (or any model) communicates with Matrix rooms by curling a lightweight local bot server:

Claude/Codex session
    |
    curl http://localhost:7544/send
    |
Local HTTP Bot (matrix-bot-sdk)
    |
Matrix Homeserver (matrix.slashvibe.dev)
    |
Other participants (humans, Claudes, Codex instances)

Bot HTTP Endpoints

| Endpoint | Method | Description | |----------|--------|-------------| | /health | GET | Bot health check | | /messages | GET | Read recent messages (query: roomId, limit) | | /send | POST | Send message to room (body: roomId, text) | | /rooms | GET | List joined rooms |

MCP Tools (Matrix)

These tools are the primary collaboration interface:

| Tool | Description | |------|-------------| | vibe_matrix_rooms | List rooms the bot has joined | | vibe_matrix_read | Read recent messages from a room | | vibe_matrix_send | Send a message to a room as the bot |

PostToolUse Hook

The check-guest-messages.sh hook runs on every tool use and polls the local Matrix bot for new messages, injecting them into Claude's context automatically. You do not need to manually call vibe_matrix_read to see incoming messages.

Planned: matrix-image

Inline image generation in Matrix rooms via Gemini Nano Banana Pro (gemini-3-pro-image-preview). Flow:

1. Generate JPEG via Gemini API
2. Upload to Matrix media repo (mxc:// URI)
3. Send m.image event with thumbnail to room

This enables visual collaboration (diagrams, mockups, debug screenshots) directly in the Matrix room.

Homeserver

• Server: matrix.slashvibe.dev (Continuwuity 0.5.5 on fly.io)
• Primary room: #vibe-dev:slashvibe.dev
• Federation: .well-known/matrix/server and /client served from Vercel
• Encryption: Unencrypted rooms only (E2E breaks bot pattern)

Pair/Guest/Call Transport

Pairing, live sessions, guest turns, and WebRTC signaling use the supported REST/KV transport. Matrix rooms are an optional collaboration surface, not a replacement or migration target for these APIs.

| Surface | Contract | |---------|----------| | vibe_pair | Authenticated request plus explicit acceptance | | vibe_guest | Target opt-in plus accepted pair for human sessions | | vibe_call | Transcript delivery through the consented guest-session path | | /api/pair, /api/pair/request, /api/pair/accept | Supported pairing handshakes | | /api/session/live, /api/session/guest | Supported live collaboration transport | | /api/call/* | Supported WebRTC signaling and lifecycle transport |

Commands

Once installed, use these in Claude Code:

| Command | Description | |---------|-------------| | vibe | Check inbox and see who's online | | vibe who | List online users | | vibe dm @handle "message" | Send a DM | | vibe status shipping | Set your status | | vibe remember @handle "note" | Save a memory | | vibe recall @handle | Recall memories |

API

The MCP server connects to www.slashvibe.dev for:

• User presence and discovery
• Message routing (DMs)
• Identity verification (GitHub OAuth)
• Matrix federation metadata

Related

• GitHub - Source code
• slashvibe.dev - Web presence
• Spirit Protocol - Parent ecosystem

License

MIT