Service Booking
Book real services through Lokuli's MCP server.
MCP Endpoint
CODEBLOCK0
Transport: SSE | JSON-RPC 2.0 | POST requests
Tools
search
Find services by query and location.
{
"method": "tools/call",
"params": {
"name": "search",
"arguments": {
"query": "smog check",
"zipCode": "90640",
"category": "Auto Services",
"maxResults": 20
}
}
}
- -
query (required): What to search for - INLINECODE1 : ZIP code to search near
- INLINECODE2 : One of: Auto Services, Music & Audio, Beauty Services, Health & Wellness, Tattoo & Body Art, Tech Repair, Tutoring & Education, Home Services, Photography & Video, Events
- INLINECODE3 : 1-50, default 20
fetch
Get detailed provider info.
CODEBLOCK2
check_availability
Get available time slots.
CODEBLOCK3
create_booking
Book and get Stripe payment link.
{
"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"
}
}
}
Returns Stripe checkout URL for payment.
get_booking
Check booking status.
CODEBLOCK5
getservicecatalog
List all 75+ service types.
CODEBLOCK6
getpricingestimates
Get typical pricing for a service.
CODEBLOCK7
validate_location
Check if ZIP code is serviceable.
CODEBLOCK8
create_cart
Create AP2 cart with JWT-signed mandate (alternative to direct checkout).
CODEBLOCK9
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. Understand — What service? Where (ZIP)?
- Search — Find matching providers
- Present — Show top results with pricing
- Fetch — Get details on selected provider
- Check availability — Get open time slots
- Confirm — Get explicit user approval
- Create booking — Generate Stripe checkout
- Share link — User completes payment
Rules
- - Never book without confirmation — Always get explicit approval
- Show pricing upfront — Use getpricingestimates if needed
- Collect required info — Name, email, phone before booking
- Default to user's ZIP — If known from context
服务预约
通过Lokuli的MCP服务器预约真实服务。
MCP端点
https://lokuli.com/mcp/sse
传输方式：SSE | JSON-RPC 2.0 | POST请求
工具
搜索
按查询内容和位置查找服务。
json
{
method: tools/call,
params: {
name: search,
arguments: {
query: 尾气检测,
zipCode: 90640,
category: 汽车服务,
maxResults: 20
}
}
}
- - query（必填）：搜索内容
- zipCode：搜索附近的邮政编码
- category：可选类别：汽车服务、音乐与音频、美容服务、健康与养生、纹身与人体艺术、科技维修、辅导与教育、家政服务、摄影与视频、活动
- maxResults：1-50，默认20
获取详情
获取服务商详细信息。
json
{
method: tools/call,
params: {
name: fetch,
arguments: {
id: 搜索获取的服务商ID
}
}
}
查看可用时段
获取可用时间段。
json
{
method: tools/call,
params: {
name: check_availability,
arguments: {
providerId: xxx,
serviceId: yyy,
date: 2025-02-10
}
}
}
创建预约
预约并获取Stripe支付链接。
json
{
method: tools/call,
params: {
name: create_booking,
arguments: {
providerId: xxx,
serviceId: yyy,
timeSlot: 2025-02-10T14:00:00-08:00,
customerName: 张三,
customerEmail: zhangsan@example.com,
customerPhone: +8613800138000
}
}
}
返回用于支付的Stripe结账URL。
查看预约
查看预约状态。
json
{
method: tools/call,
params: {
name: get_booking,
arguments: {
bookingId: stripe
sessionid
}
}
}
获取服务目录
列出全部75+种服务类型。
json
{
method: tools/call,
params: {
name: get
servicecatalog,
arguments: {
category: 全部
}
}
}
获取价格估算
获取某项服务的典型价格。
json
{
method: tools/call,
params: {
name: get
pricingestimates,
arguments: {
serviceType: 尾气检测
}
}
}
验证位置
检查邮政编码是否在服务范围内。
json
{
method: tools/call,
params: {
name: validate_location,
arguments: {
zipCode: 90640
}
}
}
创建购物车
创建带JWT签名授权的AP2购物车（替代直接结账）。
json
{
method: tools/call,
params: {
name: create_cart,
arguments: {
shopId: 服务商ID,
services: [
{sku: 服务ID, name: 尾气检测, price: 39.99, quantity: 1}
]
}
}
}
服务类别
- - 汽车服务：尾气检测、换机油、汽车精洗、汽车维修、轮胎服务
- 音乐与音频：录音棚、音乐课程、DJ服务
- 美容服务：理发、美发沙龙、美甲、化妆
- 健康与养生：按摩、脊椎矫正、私教训练
- 纹身与人体艺术：纹身、穿孔
- 科技维修：手机维修、电脑维修
- 辅导与教育：辅导、考试准备、语言学习
- 家政服务：水管工、电工、暖通空调、清洁服务
- 摄影与视频：摄影、摄像
- 活动：餐饮服务、活动策划
工作流程
- 1. 了解需求 — 什么服务？在哪里（邮政编码）？
- 搜索 — 查找匹配的服务商
- 展示 — 显示最佳结果及价格
- 获取详情 — 查看选定服务商详细信息
- 查看可用时段 — 获取空闲时间段
- 确认 — 获得用户明确同意
- 创建预约 — 生成Stripe结账
- 分享链接 — 用户完成支付
规则
- - 未经确认绝不预约 — 始终获得明确同意
- 提前展示价格 — 必要时使用获取价格估算功能
- 收集必要信息 — 预约前获取姓名、邮箱、电话
- 默认使用用户邮政编码 — 如果从上下文中已知
