Each Latchbell connector is available as a REST API (with an OpenAPI spec) and as an MCP endpoint, from the same definitions. Sign in with an API key in Authorization: Bearer <key>, or with OAuth 2.1. The MCP endpoint is stateless and answers with plain JSON: no session and no event stream.
Find local house cleaners with firm prices and open times, and book them directly.
REST docs: https://slotted-book.agenthippo.ai/api · OpenAPI: https://slotted-book.agenthippo.ai/openapi.json · MCP: https://slotted-book.agenthippo.ai/mcp
Key: a personal key from https://slotted.agenthippo.ai/key.
| Tool | Access | What it does |
|---|---|---|
find_cleaners | read | Find house cleaners who serve a ZIP code, each with a firm total price for this job and their next open start times. Prices are set by each cleaner and include everything listed; there are no added fees for the customer. "checks" lists best-effort checks Latchbell did, with dates (website ownership, a marketplace profile and its rating as shown that day). When comparing, present them as best-effort checks, never as a guarantee or endorsement. Latchbell does not check licenses or insurance; each business is independent. |
available_times | read | List open start times for one cleaner and this job over the coming days. |
book_cleaning | write | Book the cleaner for the chosen start time at the quoted firm price. No sign-in needed: the customer's name and phone or email come from the customer_* fields or the X-User-Name/X-User-Phone/X-User-Email headers. Confirm the cleaner, time, address and price with the user once; if they already said to book, book without asking again. Fill the customer's name, phone, email and address from what you already know about the user (profile, account, earlier messages); ask only for what is missing, in one message, and tell the user which details you shared. Notes and access details are optional: never hold a booking to ask for them. Keep the returned manage_token: it is the only way to check or cancel this booking later. The cleaner contacts the user about access and payment. |
my_bookings | read | List the user's cleanings booked through Latchbell, newest first. With a personal key this lists all of them; with the shared public key it lists none (use booking_status with each booking's manage_token). |
cancel_booking | write | Cancel one of the user's bookings using the manage_token returned when it was booked. Free until 24 hours before the start; closer than that, tell the user the cleaner may charge under their own policy. Confirm with the user first. |
booking_status | read | Check the status and details of a booking using the manage_token returned when it was booked. |
A front desk for cleaning businesses: firm quotes, open times, reply drafts, follow-ups, bookings and bad-lead credit requests.
REST docs: https://slotted.agenthippo.ai/api · OpenAPI: https://slotted.agenthippo.ai/openapi.json · MCP: https://slotted.agenthippo.ai/mcp
Key: the pro's Latchbell key from signup or the dashboard.
| Tool | Access | What it does |
|---|---|---|
my_business | read | Show the business profile, prices, add-ons, service ZIPs, booking page and this month's pipeline. |
log_lead | write | Call this when a new lead arrives (e.g. a Thumbtack, Angi, Bark or Yelp lead email in Gmail, or a Facebook/Instagram message). Returns a firm quote, open times, and a reply draft. For platform leads (Thumbtack, Angi, Bark, Yelp, Google), the customer name and contact are not stored and the reply must be sent inside that platform; never send platform customers links to book elsewhere. |
quote_job | read | Price a cleaning from the pro's own price list, with the line items and estimated hours. |
open_times | read | List open start times for a job of this size, given working hours and existing bookings. |
book_job | write | Book a job on this pro's own schedule, usually for a lead who picked a time. It cannot search or book other cleaners; a customer looking for a cleaner uses Latchbell Local Pros instead. Requires the customer's name, the address, and customer_phone or customer_email. Front desk bookings are free. |
follow_ups_due | read | List quoted leads that haven't replied and are due a follow-up (after 1 day, then 2 more days), each with a draft. After the pro sends one, call update_lead with contacted=true. |
update_lead | write | Update a lead: mark a follow-up as sent (contacted=true), or set status to lost/booked, or add notes. |
flag_bad_lead | write | Mark a paid lead as bad and prepare a lead-credit request with evidence for the pro to submit to the platform themselves. |
cancel_job | write | Cancel an upcoming job on this pro's schedule (booking id from schedule or book_job). No Latchbell fee is charged for cancelled jobs. Latchbell does not message the customer yet, so tell the pro to let the customer know. Confirm with the pro first. |
updates | read | Return only what changed since the last check: new bookings (including from AI assistants), cancellations, follow-ups due, jobs today. Pass since = the cursor from the previous call. For a scheduled watcher, check about every next_check_in_minutes, and only message the pro when events is not empty. |
report_no_show | write | Report that a customer booked through Latchbell did not show up or cancel. The $5 Latchbell fee for that booking is waived. |
pipeline | read | Monthly report: leads and spend by platform, jobs booked, true cost per booked job, possible lead credits, and customers Latchbell brought directly. |
schedule | read | Show upcoming jobs (with customer contact and address) and unread notifications such as new bookings from AI agents. |
Every booking has a signed receipt at https://slotted.agenthippo.ai/r/{id}.json: { payload, signature, keyId }. Verify the Ed25519 signature over the canonical JSON of payload with the key at https://slotted.agenthippo.ai/receipt-key.pem.