Public MCP documentation

Grok managed MCP

House of Vibes is a remote MCP server (no local stdio process).

Recommended config

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

Also valid (same handler):

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

Authorization

ModeHeaderStatus
Public / no-authnoneShipped — eight public tools (Grok default)
AdminAuthorization: Bearer <ADMIN_API_TOKEN>Optional — full catalog + bot-proxy ops
Member personal tokenfuture bearerSeam only — not wired (invalid Bearer → 401)

Store admin bearer in Grok's secret / headers UI only when you need ops tools — never in the public server_url.

Production fact: Omit Authorization for community + travel tools. A non-empty invalid Bearer returns 401 with an onboarding pointer to https://houseofvibes.app (never falls back to public).

Conceptual JSON shape (public / Grok default)

{
  "server_url": "https://mcp.houseofvibes.app/mcp",
  "server_label": "house-of-vibes",
  "server_description": "House of Vibes community tools (standing, events, quests, travel packages)"
}

OpenAI-compatible Responses style (public)

{
  "model": "your-model",
  "input": "What are the top builders on House of Vibes?",
  "tools": [
    {
      "type": "mcp",
      "server_label": "house-of-vibes",
      "server_url": "https://mcp.houseofvibes.app/mcp",
      "require_approval": "never"
    }
  ]
}

Admin (optional headers):

{
  "type": "mcp",
  "server_label": "house-of-vibes-admin",
  "server_url": "https://mcp.houseofvibes.app/mcp",
  "require_approval": "never",
  "headers": {
    "Authorization": "Bearer ${ADMIN_API_TOKEN}"
  }
}

Transport reminders

  • POST only for tool traffic
  • GET405
  • Notification-only POSTs → 202 empty body

See Examples and Quickstart.