Tools catalog
Documented from shipped code only. Planned names live under Roadmap.
Web app (POST /api/mcp)
Endpoint: https://mcp.houseofvibes.app/mcp Shared handler: src/lib/mcp-server.ts via /mcp and /api/mcp Identity: house-of-vibes v2 Source: src/routes/api/mcp.ts + src/lib/mcp-hov-handlers.ts Auth today: omit Authorization for public tools; admin bearer for ops tools
Public tools (no Authorization)
See also Member / community tools.
community_overview
Product one-liner, pillars, public links, MCP connection hints.
builder_path
Four-rung builder path (Belong → No-code → Vibe code → AI builder) with one next action each.
leaderboard
Top builders by total XP, level, and tier. Read-only.
| Arg | Type | Default | Notes |
|---|---|---|---|
limit | number | 10 | Clamped 1–50 |
member_stats
One member's builder stats: total XP, level, tier, daily streak, leaderboard rank.
| Arg | Type | Notes |
|---|---|---|
discord_id | string | Discord user snowflake |
user_id | string | App (Supabase) user id |
Unauthenticated callers pass one of the above. Future member principals self-scope.
upcoming_events
Upcoming vetted virtual events/opportunities, sorted by soonest start.
| Arg | Type | Default | Notes |
|---|---|---|---|
limit | number | 8 | Clamped 1–25 |
min_score | number | 70 | Opportunity score 0–100 |
open_quests_and_bounties
Community quest catalog and open/claimed bounty board. Proxied from bot public board.
hangout_info
Public facts for the Daily Hangout (schedule, lounge, /daily link). Not live admin Discord resolution.
search_stay_packages
National best-value short-term stay packages via Travel packages API (not nearest-hotel OTA).
| Arg | Type | Notes | ||||
|---|---|---|---|---|---|---|
origin | string | Required. Traveler home base, e.g. Austin, TX | ||||
checkIn | string | YYYY-MM-DD; default ~+14 days | ||||
nights | number | Snapped to 3\ | 7\ | 14\ | 21\ | 28 |
budget | number | Max lodging TOTAL for the stay | ||||
propertyType | string | entireplace / privateroom / vacation_rental / hotel / any | ||||
amenities | string[] | wifi, kitchen, laundry, parking, petfriendly, pool, hottub, workspace | ||||
minRating | number | Optional floor | ||||
limit | number | 1–25, default 12 |
When inventory is thin or empty, the response includes an honesty envelope — never invent listings. See Travel honesty.
Admin-only tools (web app, bot proxy)
Require Authorization: Bearer <ADMIN_API_TOKEN>. Call Railway bot with BOT_SERVICE_URL + ADMIN_API_TOKEN. Missing env → graceful not-configured result.
hangout_status
Live Daily Builder Hangout status (resolved config, channels, next occurrence).
list_scheduled_events
Scheduled Discord events via bot admin route.
Other admin proxies
server_map, eventbrite_registrations, activation_status, run_hangout_eventsync, delete_scheduled_event, vibe_server_command.
Full detail: Admin tools.
Bot-service admin (POST /mcp on Railway)
Source: workers/discord-bot-service/src/routes/mcp.ts 8 tools including activation_status — see Admin tools. Always admin bearer. Prefer web public tools for Grok end users.
Not shipped (do not call)
| Name | Notes |
|---|---|
my_rank / my_stats | Use member_stats + leaderboard |
whos_live | Lounge presence — not built |
open_quests / bounty_board | Combined as open_quests_and_bounties |
onboarding_status / funnel / configure_onboarding | Not on admin MCP |
ask_vibe / find_builders / showcase submit | Phase 3 ideas |
Builder XP tiers (reference)
| Min XP | Level | Title |
|---|---|---|
| 0 | 0 | Newcomer |
| 50 | 1 | Builder |
| 150 | 2 | Shipper |
| 350 | 3 | Maker |
| 700 | 4 | Craftsperson |
| 1200 | 5 | Architect |
| 2000 | 6 | Legend |