Lokuli 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 服务预订
通过 Lokuli 的 MCP 服务器预订真实服务。
MCP 端点
https://lokuli.com/mcp/sse
传输方式：SSE | JSON-RPC 2.0 | POST 请求
工具
search（搜索）
按查询条件和位置查找服务。
json
{
method: tools/call,
params: {
name: search,
arguments: {
query: smog check,
zipCode: 90640,
category: Auto Services,
maxResults: 20
}
}
}
- - query（必填）：搜索内容
- zipCode：附近搜索的邮政编码
- category：可选类别：汽车服务、音乐与音频、美容服务、健康与养生、纹身与身体艺术、科技维修、辅导与教育、家政服务、摄影与视频、活动
- maxResults：1-50，默认值为 20
fetch（获取）
获取详细的服务商信息。
json
{
method: tools/call,
params: {
name: fetch,
arguments: {
id: provider
idfrom_search
}
}
}
check_availability（检查可用性）
获取可用的时间段。
json
{
method: tools/call,
params: {
name: check_availability,
arguments: {
providerId: xxx,
serviceId: yyy,
date: 2025-02-10
}
}
}
create_booking（创建预订）
预订并获取 Stripe 支付链接。
json
{
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 结账 URL。
get_booking（获取预订信息）
查看预订状态。
json
{
method: tools/call,
params: {
name: get_booking,
arguments: {
bookingId: stripe
sessionid
}
}
}
getservicecatalog（获取服务目录）
列出所有 75 种以上的服务类型。
json
{
method: tools/call,
params: {
name: get
servicecatalog,
arguments: {
category: All
}
}
}
getpricingestimates（获取价格估算）
获取某项服务的典型定价。
json
{
method: tools/call,
params: {
name: get
pricingestimates,
arguments: {
serviceType: smog check
}
}
}
validate_location（验证位置）
检查邮政编码是否在服务范围内。
json
{
method: tools/call,
params: {
name: validate_location,
arguments: {
zipCode: 90640
}
}
}
create_cart（创建购物车）
创建带有 JWT 签名授权的 AP2 购物车（直接结账的替代方案）。
json
{
method: tools/call,
params: {
name: create_cart,
arguments: {
shopId: provider_id,
services: [
{sku: service_id, name: Smog Check, price: 39.99, quantity: 1}
]
}
}
}
类别
- - 汽车服务：尾气检测、换油、汽车精洗、汽车维修、轮胎服务
- 音乐与音频：录音棚、音乐课程、DJ 服务
- 美容服务：理发店、美发沙龙、美甲、化妆
- 健康与养生：按摩、脊椎按摩、私人教练
- 纹身与身体艺术：纹身、穿孔
- 科技维修：手机维修、电脑维修
- 辅导与教育：辅导、考试准备、语言学习
- 家政服务：水管工、电工、暖通空调、清洁服务
- 摄影与视频：摄影、摄像
- 活动：餐饮服务、活动策划
工作流程
- 1. 了解——需要什么服务？在哪里（邮政编码）？
- 搜索——查找匹配的服务商
- 展示——显示包含定价的顶级结果
- 获取——获取选定服务商的详细信息
- 检查可用性——获取空闲时间段
- 确认——获得用户的明确批准
- 创建预订——生成 Stripe 结账
- 分享链接——用户完成支付
规则
- - 未经确认绝不预订——始终获得明确批准
- 提前显示定价——如有需要，使用 getpricingestimates
- 收集必要信息——预订前获取姓名、邮箱、电话
- 默认使用用户的邮政编码——如果从上下文中已知
