Skip to main content
MassageGo
EN

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, Facial, Coffee & Milk Body Scrub) 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 up to 20 matches (plus a total_matched count) — narrow the query if more exist. Use the hotel name directly as the location field when booking.

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
  hotel_access_confirmed?: boolean
  // required true if location is a hotel/resort/serviced residence —
  // ask the guest whether they've told reception a therapist is coming
}

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

  1. AI calls list_services to confirm valid service names and durations.
  2. AI collects guest details: name, hotel/address, date, time, service, contact number.
  3. If the location is a hotel, resort, or serviced residence, AI asks the guest whether they've already told hotel reception a therapist is coming, and sets hotel_access_confirmed: true — some properties restrict in-room massage without notice, and submit_booking rejects hotel locations without it.
  4. AI calls submit_booking — booking lands in admin queue with status pending_ai_review.
  5. MassageGo admin reviews and confirms within 30 minutes, contacting the guest via WhatsApp or phone.
  6. Therapist arrives. Guest pays cash in VND directly to therapist after the session. No advance payment ever.
REST API reference →llms.txtMCP specification ↗