Examples

Replace $MCP_URL with https://mcp.houseofvibes.app/mcp.

Public tools need no Authorization. Set $ADMIN_API_TOKEN only for admin examples.

All examples use Streamable HTTP JSON response mode (POST + JSON body).

curl - initialize (public)

curl -sS -X POST "$MCP_URL" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-06-18",
      "capabilities": {},
      "clientInfo": { "name": "curl", "version": "1.0" }
    }
  }'

curl - tools/list (public)

curl -sS -X POST "$MCP_URL" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/list",
    "params": {}
  }'

curl - tools/call (leaderboard, public)

curl -sS -X POST "$MCP_URL" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "leaderboard",
      "arguments": { "limit": 5 }
    }
  }'

curl - admin tools/list

curl -sS -X POST "$MCP_URL" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ADMIN_API_TOKEN" \
  -d '{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/list",
    "params": {}
  }'

xAI / Grok managed MCP

from xai_sdk.tools import mcp

tools = [
    mcp(
        server_url="https://mcp.houseofvibes.app/mcp",
        server_label="house-of-vibes",
        server_description="House of Vibes builder community + travel packages",
    ),
]

Admin (optional):

import os
from xai_sdk.tools import mcp

tools = [
    mcp(
        server_url="https://mcp.houseofvibes.app/mcp",
        server_label="house-of-vibes-admin",
        authorization=os.environ["HOV_ADMIN_API_TOKEN"],
    ),
]