Public MCP documentation

Connect (Grok)

This page is an alias of Grok managed MCP. Prefer that URL going forward.

Quick fields

FieldValue
server_urlhttps://mcp.houseofvibes.app/mcp
server_labelhouse-of-vibes
server_description (optional)Discord-native builder community + travel packages. Streamable HTTP JSON-RPC for Grok managed MCP.
authorizationomit for public tools

Authorization

ModeHeaderWhen
Public / community + travelnoneDefault for Grok. Eight public tools without a token.
Admin / full catalogAuthorization: Bearer <ADMIN_API_TOKEN>Optional — hangout live status, scheduled events, bot-proxy ops. Same token as other HoV admin APIs. Never commit or paste into public docs.

Production fact (web app): POST /mcp and POST /api/mcp accept unauthenticated requests as the public principal. Invalid non-empty Bearer values return 401 (member seam not wired). Grok configs for community tools should not require a secret.

URL aliases

All of these hit the same shared handler:

https://mcp.houseofvibes.app/mcp
https://houseofvibes.app/mcp
https://mcp.houseofvibes.app/api/mcp
https://houseofvibes.app/api/mcp

Prefer `https://mcp.houseofvibes.app/mcp`.

Transport rules

  1. Method: POST only for JSON-RPC.
  2. Content-Type: application/json
  3. Body: one JSON-RPC object, or a batch array of objects.
  4. GET: returns 405 — this server does not open a server→client SSE stream (stateless JSON response mode).
  5. Notifications only (e.g. notifications/initialized with no id): HTTP 202, empty body.

Suggested session flow

  1. initialize → read serverInfo and protocolVersion
  2. notifications/initialized (notification)
  3. tools/list → cache tool names + schemas
  4. tools/call as needed

See Examples for curl, xAI SDK, and OpenAI-compatible shapes.

Admin-tier bot MCP (ops)

Full Discord ops tools also live on the Railway bot-service at POST /mcp (not the public docs hostname). That endpoint always requires Authorization: Bearer <ADMIN_API_TOKEN>. See Admin tools.

Do not put Railway internal URLs in end-user Grok configs unless you are an operator with network access to that service.

Full detail: Grok managed MCP · Quickstart · Auth