Lokuli 服务预订

通过 Lokuli 的 MCP 服务器预订真实服务。

MCP 终端地址（Endpoint）

https://lokuli.com/mcp/sse

传输协议：SSE | JSON-RPC 2.0 | POST 请求

工具（Tools）

search

根据查询关键词和地理位置查找服务。

{
  "method": "tools/call",
  "params": {
    "name": "search",
    "arguments": {
      "query": "smog check",
      "zipCode": "90640",
      "category": "Auto Services",
      "maxResults": 20
    }
  }
}

• query（必填）：搜索关键词
• zipCode：用于限定搜索范围的邮政编码（ZIP code）
• category：类别，可选值包括：Auto Services、Music & Audio、Beauty Services、Health & Wellness、Tattoo & Body Art、Tech Repair、Tutoring & Education、Home Services、Photography & Video、Events
• maxResults：返回结果数量，取值范围为 1–50，默认为 20

fetch

获取服务商的详细信息。

{
  "method": "tools/call",
  "params": {
    "name": "fetch",
    "arguments": {
      "id": "provider_id_from_search"
    }
  }
}

check_availability

获取可预约的时间段。

{
  "method": "tools/call",
  "params": {
    "name": "check_availability",
    "arguments": {
      "providerId": "xxx",
      "serviceId": "yyy",
      "date": "2025-02-10"
    }
  }
}

create_booking

创建预约并获取 Stripe 支付链接。

{
  "method": "tools/call",
  "params": {
    "name": "create_booking",
    "arguments": {
      "providerId": "xxx",
      "serviceId": "yyy",
      "timeSlot": "2025-02-10T14:00:00-08:00",
      "customerName": "John Doe",
      "customerEmail": "john@example.com",
      "customerPhone": "+13105551234"
    }
  }
}

返回 Stripe Checkout URL 用于完成支付。

get_booking

查询预约状态。

{
  "method": "tools/call",
  "params": {
    "name": "get_booking",
    "arguments": {
      "bookingId": "stripe_session_id"
    }
  }
}

get_service_catalog

列出全部 75+ 种服务类型。

{
  "method": "tools/call",
  "params": {
    "name": "get_service_catalog",
    "arguments": {
      "category": "All"
    }
  }
}

get_pricing_estimates

获取某项服务的典型价格区间。

{
  "method": "tools/call",
  "params": {
    "name": "get_pricing_estimates",
    "arguments": {
      "serviceType": "smog check"
    }
  }
}

validate_location

验证邮政编码（ZIP code）是否在服务覆盖范围内。

{
  "method": "tools/call",
  "params": {
    "name": "validate_location",
    "arguments": {
      "zipCode": "90640"
    }
  }
}

create_cart

使用 JWT 签名授权创建 AP2 购物车（替代直接跳转至 checkout 的方式）。

{
  "method": "tools/call",
  "params": {
    "name": "create_cart",
    "arguments": {
      "shopId": "provider_id",
      "services": [
        {"sku": "service_id", "name": "Smog Check", "price": 39.99, "quantity": 1}
      ]
    }
  }
}

服务类别（Categories）

• Auto Services：Smog Check、Oil Change、Detailing、Mechanic、Tires
• Music & Audio：Recording Studios、Music Lessons、DJ Services
• Beauty Services：Barber、Hair Salon、Nails、Makeup
• Health & Wellness：Massage、Chiropractor、Personal Training
• Tattoo & Body Art：Tattoo、Piercing
• Tech Repair：Phone Repair、Computer Repair
• Tutoring & Education：Tutoring、Test Prep、Language
• Home Services：Plumber、Electrician、HVAC、Cleaning
• Photography & Video：Photography、Videography
• Events：Catering、Event Planning

标准工作流程（Workflow）

1. 理解需求 — 明确所需服务类型及地理位置（ZIP code）
2. 搜索服务 — 查找匹配的服务提供商
3. 呈现结果 — 展示排名靠前的结果，并附带价格信息
4. 获取详情 — 获取用户选定服务商的详细信息
5. 检查可用性 — 获取该服务商当前开放的可预约时间段
6. 确认预约 — 明确获得用户的最终确认
7. 创建预约 — 生成 Stripe Checkout 链接
8. 分享链接 — 用户点击链接完成支付

使用规则（Rules）

• 未经确认不得预约 — 必须明确获得用户授权
• 价格需前置展示 — 如有需要，调用 get_pricing_estimates 获取价格参考
• 提前收集必要信息 — 预约前必须获取用户姓名、邮箱和电话号码
• 默认使用用户所在 ZIP code — 若上下文已知用户所在地邮政编码，则优先采用