House of Vibes MCP
House of Vibes (HoV) MCP exposes community data, travel package search, and (for admins) bot controls as Model Context Protocol tools so coding agents, chat assistants, and managed MCP clients can use Vibe without scraping Discord or the web app.
Live today (honest)
- Transport: Streamable HTTP in JSON-response mode —
POSTJSON-RPC, get JSON back. - GET on the MCP path returns 405 (no long-lived SSE stream).
- Notifications with no JSON-RPC
id(e.g.notifications/initialized) return HTTP 202 with an empty body. - Grok managed MCP compatible — point Grok at the canonical URL and label below; no Authorization required for public tools.
- Two tiers, two hosts:
- Web app (Vercel) — public community + travel tools; optional admin bearer for bot-proxy ops. Entry:
https://mcp.houseofvibes.app/mcp. - Bot service (Railway) — full admin ops surface (
server_map,vibe_server_command, etc.). Always token-gated. - Travel:
search_stay_packagesis shipped as a public tool with honesty envelopes when inventory is thin. See Travel honesty.
Working endpoints (web app)
Same Vercel app and handler (src/routes/api/mcp.ts → handleMcpHttp):
https://houseofvibes.app/api/mcphttps://mcp.houseofvibes.app/api/mcp
Vanity rewrites (same handler):
https://mcp.houseofvibes.app/mcphttps://houseofvibes.app/mcp
server_label: house-of-vibes
Prefer `https://mcp.houseofvibes.app/mcp` for Grok and other managed remote MCP configs.
Auth in one line
| Principal | How | Status |
|---|---|---|
| Public | Omit Authorization | Shipped — community + travel tools |
| Admin | Bearer ADMIN_API_TOKEN | Shipped — full catalog + bot proxies |
| Member | Personal token / Discord OAuth | Seam only → 401 until wired |
Two tiers, two hosts
| Tier | Host | Path | Auth today |
|---|---|---|---|
| Web app (community + travel + thin admin proxies) | Vercel | POST /api/mcp (and /mcp rewrite) | Public by default; admin bearer for ops tools |
| Bot service (full admin ops) | Railway | POST /mcp | Admin bearer only |
Web identity: house-of-vibes v2. Bot identity: house-of-vibes + bot build string.
Protocol methods
| Method | Purpose |
|---|---|
initialize | Negotiate protocol; return serverInfo + capabilities |
notifications/initialized | Client ack → HTTP 202 |
ping | Liveness |
tools/list | Tool catalog for the authenticated principal |
tools/call | Invoke one tool by name + arguments |
Protocol version advertised: `2025-06-18`.
| Field | Value |
|---|---|
serverInfo.name | house-of-vibes |
serverInfo.version | 2 |
Design principles
- Public by default for Grok — eight public tools without a token.
- Admin tools re-use existing guards — bot-proxy tools need admin bearer; full ops can stay on the bot MCP.
- Travel honesty —
search_stay_packagesuses real inventory paths and returns an honesty envelope when inventory is thin. See Travel.