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_packagesandsearch_month_hopsare public tools 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 | Bearer hovmcp_… Discord-linked personal token | Shipped — self-scoped member principal; invalid/mismatched bearer → 401 |
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; Discord-linked member bearer (hovmcp_…) for self-scoped member tools; 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 — public community + travel 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_packages/search_month_hopsuse real inventory paths and return honesty envelopes when inventory is thin (including empty hops). See Travel.