Developer

MassageGo MCP Server

Connect any MCP-compatible AI assistant to MassageGo. Search services, look up hotels, and book in-room massage in Ho Chi Minh City — all from your AI chat window.

Quick Setup

Claude Desktop

Edit ~/.claude/claude_desktop_config.json

{
  "mcpServers": {
    "massagego": {
      "url": "https://massagego.co/api/mcp",
      "transport": "http"
    }
  }
}

Cursor / Windsurf

Add to your MCP settings:

{
  "name": "massagego",
  "url": "https://massagego.co/api/mcp",
  "transport": "http"
}

Endpoint

POST https://massagego.co/api/mcp

Protocol: MCP 2024-11-05 · Stateless HTTP · No auth required

Available Tools

list_servicesNo params

Returns all services (Foot, Aroma, Thai, Shiatsu, Hot Stone, Cupping, Head & Shoulder) with available durations and prices in VND. Call this first to get validmassage_type andduration values for booking.

get_booking_infoNo params

Returns operating hours (9 AM–9 PM, outside on request), payment policy (cash only, after session), confirmation time (30 min), surcharges, service area, and contact details.

search_hotelsquery?: string

Search 100+ covered hotels by name or district. Returns hotel name and district. Use the hotel name directly as the location field when booking. Leave query empty to browse all.

submit_booking8 required fields

Submit a booking request. Lands in a moderation queue — admin confirms within 30 minutes and contacts the guest. Payment is cash to therapist after session. Rate limit: 5 submissions / hour / IP.

{
  customer_name:    string   // required
  location:         string   // required — hotel + room, or address
  booking_date:     string   // required — YYYY-MM-DD
  booking_time:     string   // required — HH:MM (24h)
  massage_type:     string   // required — from list_services
  duration:         string   // required — "60", "90", or "120"
  contact:          string   // required — WhatsApp / phone
  number_of_people: number   // required — 1 to 20
  email?:           string   // optional
  special_requests?: string  // optional
}

Test with curl

Initialize handshake

curl -X POST https://massagego.co/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

List available tools

curl -X POST https://massagego.co/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

List services with pricing

curl -X POST https://massagego.co/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"list_services","arguments":{}}}'

How AI Bookings Work

AI calls list_services to confirm valid service names and durations.
AI collects guest details: name, hotel/address, date, time, service, contact number.
AI calls submit_booking — booking lands in admin queue with status pending_ai_review.
MassageGo admin reviews and confirms within 30 minutes, contacting the guest via WhatsApp or phone.
Therapist arrives. Guest pays cash in VND directly to therapist after the session. No advance payment ever.

REST API reference →llms.txt MCP specification ↗