Local Booking

Book real local services through Lokuli's MCP server.

MCP Endpoint

https://lokuli.com/mcp/sse

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
• zipCode: ZIP code to search near
• category: One of: Auto Services, Music & Audio, Beauty Services, Health & Wellness, Tattoo & Body Art, Tech Repair, Tutoring & Education, Home Services, Photography & Video, Events
• maxResults: 1-50, default 20

fetch

Get detailed provider info.

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

check_availability

Get available time slots.

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

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": "[email protected]",
      "customerPhone": "+13105551234"
    }
  }
}

Returns Stripe checkout URL for payment.

get_booking

Check booking status.

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

get_service_catalog

List all 75+ service types.

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

get_pricing_estimates

Get typical pricing for a service.

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

validate_location

Check if ZIP code is serviceable.

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

create_cart

Create AP2 cart with JWT-signed mandate (alternative to direct 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. Understand — What service? Where (ZIP)?
2. Search — Find matching providers
3. Present — Show top results with pricing
4. Fetch — Get details on selected provider
5. Check availability — Get open time slots
6. Confirm — Get explicit user approval
7. Create booking — Generate Stripe checkout
8. Share link — User completes payment

Rules

• Never book without confirmation — Always get explicit approval
• Show pricing upfront — Use get_pricing_estimates if needed
• Collect required info — Name, email, phone before booking
• Default to user's ZIP — If known from context