Public MCP documentation

Admin tools

Bot-service admin MCP (full ops)

Endpoint: Railway bot-service POST /mcp Auth: always Authorization: Bearer <ADMIN_API_TOKEN> Identity: house-of-vibes / bot build string Source: workers/discord-bot-service/src/routes/mcp.ts

Each tools/call dispatches to an existing admin route — guards reused.

ToolMethodNotes
server_mapGETChannel/category map
list_scheduled_eventsGETEvents tab
hangout_statusGETDaily hangout live status
eventbrite_registrationsGETRegistration counts
activation_statusGETOnboarding/funnel/XP flywheel (read-only)
run_hangout_eventsyncPOSTIdempotent event-sync
delete_scheduled_eventPOSTevent_ids: string[] — refuses Hangout/Demo Day
vibe_server_commandPOSTcommand, optional confirm — plan then confirm

Eight shipped admin tools (including activation_status).

Transport: POST only; GET405; notifications → 202.


Web app admin proxies

On POST /api/mcp (admin principal) the web handler also exposes bot-proxy tools:

ToolNeeds on Vercel
hangout_statusBOT_SERVICE_URL + ADMIN_API_TOKEN
list_scheduled_eventssame
server_mapsame
eventbrite_registrationssame
activation_statussame
run_hangout_eventsyncsame
delete_scheduled_eventsame
vibe_server_commandsame

Without that env pair → clear "bot-proxy not configured" tool result. Public community + travel tools still work without bot proxy env.


Operator safety

  1. Plan vibe_server_command without confirm, then re-run with confirm: true.
  2. delete_scheduled_event only deletes exact ids; refuses core HoV events.
  3. activation_status never writes.