io.github.kirubel/kirah-local-services

Kirah Local Services

Discover local services and availability, then create, track, reschedule, or cancel bookings.

1.1.0
Version
remote
Transport
10
Tools

Security review

Review passed

Reviewed 19h ago.

  • tools: 10 tools scanned
  • metadata: scanned

No findings.

Tools (10)

  • list_services

    Returns one published Kirah business catalog with current services, providers, timezone, prices, durations, deposit requirements, intake-question definitions and derived booking capabilities.

  • search_services

    Ranks up to five services in one published Kirah business catalog against a short free-text query. Returns catalog-grounded candidate identifiers, names, scores and match evidence.

  • get_availability

    Returns current open times for one exact service and optional provider over a YYYY-MM-DD range of up to 31 days, with at most 20 rows. Approval-mode times are preferences rather than holds.

  • search_businesses

    Searches Kirah's eligible public business directory by service need or exact Kirah Agent Address, with optional coarse location, price and demo-mode filters. Demo results are explicitly labeled.

  • find_available_services

    Checks up to five top matching eligible Kirah businesses for earliest current availability within an exact ISO-8601 window of up to 14 days. Returns checked status and a partial-coverage flag.

  • get_booking_status

    Returns the current status, time, service and provider for one grant-authorized booking reference. Client contact details and intake responses are excluded.

  • get_reschedule_options

    Returns up to five real alternate times and the current fee or approval consequences for one grant-authorized booking. It does not hold, move or cancel the appointment.

  • reschedule_booking

    Atomically moves one grant-authorized booking to a real open time after explicit user confirmation. Reusing idempotency_key makes retries safe. Failure leaves the original booking unchanged; success returns a rotated grant.

  • cancel_booking

    Cancels one grant-authorized booking after explicit user confirmation. Reusing idempotency_key makes retries safe. Kirah refuses cancellations that could refund a charged deposit or restore a paid plan session; an allowed cancellation has no undo.

  • create_booking

    Creates one guest booking for an exact service, provider and ISO-8601 start time after explicit user confirmation. Reusing idempotency_key makes retries safe. Kirah accepts no payment credentials through MCP; a deposit-required service may return a Kirah-hosted human payment continuation, but this call transfers no funds.