Fold Laundry
Measured conclusion: Deep-tested. L2 outcome: tools_ok.
Book, track and manage laundry & dry-cleaning pickup in Los Angeles and San Francisco.
| Author | com.foldlaundry |
|---|---|
| Access | remote |
| Publisher key required | No |
| Measured state | Deep-tested |
| L1 liveness | alive |
| L1 latency | 2912 ms |
| Last measured | 2026-10-24 |
Add to your agent
Copy this into your MCP client config:
{
"mcpServers": {
"Fold Laundry": {
"url": "https://foldlaundry.com/mcp",
"transport": "streamable-http"
}
}
}
Measured tools (34)
search_hotelsread-onlySearch for a hotel by name within Fold service areas (Los Angeles and San Francisco). Returns up to 6 hotels matching the query with their place IDs (used in book_hotel_pickup) and addresses. book_hotel_pickup requires one of these hotelPlaceIds.
Parameters:
query(required) — string — Hotel name or address. Minimum 2 characters. Example: "Four Seasons Beverly Hills" or "Marriott San Francisco".
Hints: read-only yes · destructive no · idempotent yes · open-world yes
book_hotel_pickupdestructiveSchedule a laundry pickup for a hotel guest. Creates an order without requiring a Fold account. Returns an order tracking code (FHL-XXXXXX) and a Stripe payment-setup URL. The user must visit the Stripe URL to enter their card before pickup. The card is NOT charged at booking — only after intake when the actual price is known. Hotel guest pricing: wash & fold is $49.99 flat for up to 15 lb, then $2.65/lb over 15 lb; dry cleaning is priced per garment. $49.99 hotel order minimum (covers wash & fold and dry cleaning — smaller orders are billed at $49.99). A flat $9.99 hotel service charge is added to every hotel booking on top of that, and the $30 Express surcharge (when chosen) is also on top — neither counts toward the minimum. Return-time tiers: • same_day — guest must drop the bag before 9 AM Pacific. Standard same-day return (back by 8 PM), no surcharge. Covers wash & fold AND dry cleaning. • express_same_day — drop between 9 AM and 12 PM. ⚡ Express same-day (back by 8 PM tonight). $30 flat surcharge. • next_day — drop any time. Standard next-day return (back by 8 PM tomorrow). No surcharge. Most common choice. • flexible — 48+ hours. No surcharge. Same-day options are not available after 12 PM Pacific time (Los Angeles / San Francisco); requests after noon are next_day or later. The server enforces these cut-offs on its own clock: a same_day request between 9 AM and noon is refused with a message to use express_same_day (+$30) — confirm the $30 with the guest before retrying — and any same-day request after noon is refused (use next_day). It never adds a surcharge or changes the day silently.
Parameters:
hotelPlaceId(required) — string — Google Place ID for the hotel, obtained from search_hotels. Required.hotelName(required) — string — Hotel display name (from search_hotels result). Required.guestFirstName(required) — string — Guest first nameguestLastName(required) — string — Guest last nameguestEmail(required) — string — Guest email (used for tracking + receipts)guestPhone(required) — string — Guest phone in E.164 format (+1XXXXXXXXXX) or US 10-digitroomNumber(required) — string — Guest room number at the hotelservices(required) — array — What services to perform. Most guests pick WASH_AND_FOLD.returnPreference(required) — string — When the guest wants the laundry back. same_day requires drop-off before 9 AM (no surcharge). express_same_day works for drop-off between 9 AM and 12 PM noon (+$30 surcharge, back by 8 PM tonight). next_day is the typical choice — drop any time, back by 8 PM tomorrow (no surcharge). flexible = 48hr+. Pick same_day or express_same_day only if local time clearly allows it.notes— string — Optional special instructions (e.g. "no fabric softener", "handle silk delicately").idempotencyKey— string — OPTIONAL — pass a unique identifier (UUID recommended) to make this call safe to retry. If we have already seen this key, we return the EXISTING order code instead of creating a duplicate. Highly recommended for production agents that may retry on network errors.
Hints: read-only no · destructive yes · idempotent no · open-world yes
join_waitlistAdds an email address to Fold's waitlist for a ZIP code Fold doesn't serve yet; Fold emails if service starts there. Only for unserved ZIPs (served ZIPs return an error saying Fold already serves them). Use the person's own email with their permission.
Parameters:
email(required) — string — The person's email address.zipCode(required) — string — 5-digit US ZIP code where they want service.firstName— string — Optional first name.
Hints: read-only no · destructive no · idempotent yes · open-world no
check_service_zipread-onlyCheck whether Fold serves a given ZIP code. Returns service availability, the market name (LA/SF), and a list of pickup window options that can be passed to book_residential_pickup. book_residential_pickup only accepts ZIPs this tool reports as served.
Parameters:
zipCode(required) — string — 5-digit US ZIP code, e.g. "90210" or "94103". ZIP+4 and full addresses are accepted; the 5-digit ZIP is extracted.
Hints: read-only yes · destructive no · idempotent yes · open-world not declared
book_residential_pickupdestructiveSchedule a laundry pickup at a residential address. For any non-hotel address in the service area, including Airbnb and other vacation rentals (the rental address is the pickup address). Creates a guest customer account (no password needed — they can claim it later by signing up with the same email). Returns an order code (FOLD-XXXXX) and a Stripe payment-setup URL. The card is NOT charged until after intake. $39.99 order minimum applies. Only ZIPs served by Fold are accepted (see check_service_zip).
Parameters:
firstName(required) — string — Customer first namelastName(required) — string — Customer last nameemail(required) — string — Customer email (used for tracking + receipts)phone(required) — string — Customer phone in E.164 format (+1XXXXXXXXXX) or US 10-digitline1(required) — string — Street address line 1, e.g. "123 Main St"city(required) — string — City, e.g. "Los Angeles"state(required) — string — US state code, e.g. "CA"zipCode(required) — string — 5-digit ZIP. Must be in service area (use check_service_zip first).services(required) — array — What services to perform.pickupDate(required) — string — YYYY-MM-DD date for pickup. Must be today or in the future.pickupWindow(required) — string — Pickup time window label from check_service_zip.pickupWindows, e.g. "9-11 AM".line2— string — Apartment / suite / unit (optional)notes— string — Optional special instructions about the laundry (e.g. "no fabric softener").deliveryDate— string — YYYY-MM-DD delivery date. Defaults to pickup date + 1 day if omitted.deliveryNotes— string — How to find / deliver to the address (gate code, doorman, leave at door, etc.).deliveryWindow— string — Delivery time window label from check_service_zip.deliveryWindows. EVENING ONLY — Fold does not deliver in the morning. Defaults to the evening window if omitted.idempotencyKey— string — OPTIONAL — pass a unique identifier (UUID recommended) to make this call safe to retry. If we have already seen this key, we return the EXISTING order code instead of creating a duplicate. Highly recommended for production agents that may retry on network errors.
Hints: read-only no · destructive yes · idempotent no · open-world yes
track_orderread-onlyCheck the status of any Fold order — works for both hotel-guest pickups and residential pickups. Needs the order code (FOLD-XXXXXX or FHL-XXXXXX) plus the email used at booking; with a connected Fold account the email is not needed. Returns current state, a milestone timeline, scheduled dates, items if itemized, and proof-of-delivery photo URL if delivered.
Parameters:
email— string — Email used at booking. Not needed when the customer has connected their Fold account.orderCode— string — Order tracking code like FHL-RRKU92 (hotel) or FOLD-K9ZGQ (residential). Optional when the customer has connected their Fold account: omit it to get their most recent order.
Hints: read-only yes · destructive no · idempotent yes · open-world not declared
cancel_orderdestructiveCancel a Fold order. Allowed only before the driver has picked up the bag — after pickup, items have to be returned unprocessed instead (the customer should call support). Requires the order code and the email used at booking. Returns the new state and confirms the saved card was not charged.
Parameters:
orderCode(required) — string — Order code like FHL-RRKU92 or FOLD-K9ZGQ.email— string — Email used at booking. Not needed when the customer has connected their Fold account.reason— string — Optional reason — shown to ops, helps us improve.
Hints: read-only no · destructive yes · idempotent yes · open-world not declared
enroll_in_clubdestructiveEnroll a Fold customer in Fold Club. Requires a recent order code + email for identity (same auth model as track_order). The customer MUST have a saved card on file — if not, we return an error pointing them to /app/payment. Three plans: WF_CLUB (Wash & Fold $19.99/mo or $219.89/yr), DC_CLUB (Dry Cleaning $12.99/mo or $142.89/yr), ALL_IN (Wash & Fold + Dry Cleaning $29.99/mo or $329.89/yr). Annual billing: 1 month free (pay for 11 months). The card is charged immediately and the plan renews automatically (every month, or every year for ANNUAL) at that price until cancelled; cancel any time in the app (Account → Fold Club) — the plan then runs to the end of the paid month/year with no refund for unused time. Before calling this tool, tell the customer the exact amount, that it renews automatically, and how to cancel, and get their explicit yes. promoCode WELCOME gives the first month free on MONTHLY billing only (it is typically sent to customers by SMS/email after their first delivery); promo codes are rejected on ANNUAL.
Parameters:
recentOrderCode(required) — string — A recent Fold order code (FOLD-XXXXX) belonging to this customer — used as proof of identity.plan(required) — string — Which Club plan to enroll in.billingInterval(required) — string — Billing cadence. ANNUAL: 1 month free (pay for 11 months), charged once per year in advance, renews automatically each year.email— string — Customer email — must match the recentOrderCode owner.promoCode— string — Optional Stripe promo code (e.g. WELCOME for first month free). MONTHLY billing only.
Hints: read-only no · destructive yes · idempotent no · open-world yes
reschedule_orderdestructiveMove the pickup date/window, delivery date/window, or both, on an existing order. Pickup can only be moved while still in SCHEDULED or PICKUP_ASSIGNED (i.e. driver has not started). Delivery can be moved any time before the delivery driver is en route. Requires order code + email. Pass at least one leg.
Parameters:
orderCode(required) — string — Order code (FHL-XXXXXX or FOLD-XXXXX).email— string — Email used at booking. Not needed when the customer has connected their Fold account.newPickupDate— string — YYYY-MM-DD — new pickup calendar date.newDeliveryDate— string — YYYY-MM-DD — new delivery calendar date.newPickupWindow— string — Pickup window label, e.g. "9-11 AM".newDeliveryWindow— string — Delivery window label from check_service_zip.deliveryWindows (evening only, e.g. "6:30 PM – 9:30 PM").
Hints: read-only no · destructive yes · idempotent yes · open-world not declared
list_my_ordersread-onlyList the customer's recent Fold orders (most recent first, max 10). If the customer has connected their Fold account to this assistant, returns each order's code, status, dates and address — no email needed. Without a connected account, only says how many recent orders exist (order codes are never revealed from an email alone, for privacy) — use the order code from the customer's confirmation text/email with track_order, or ask them to connect Fold.
Parameters:
email— string — Customer email. Only used when the customer has NOT connected their Fold account; then only a count is returned.
Hints: read-only yes · destructive no · idempotent yes · open-world not declared
get_estimateread-onlyCalculate an itemized price estimate for what the user actually wants — bags or pounds of wash & fold plus dry-cleaning garments named in plain words (e.g. '2-piece suit', 'dress shirt', 'winter coat'). Answers 'how much will it cost' before booking. Returns line items, subtotal, and total in cents and USD (no hidden fees; orders under the $39.99 minimum are billed at the minimum). Note: the actual charge is calculated at intake when bags are weighed, but this estimate is accurate to within ~10% for typical orders. These are residential prices — hotel guest orders are priced differently (see get_pricing hotelGuestRates).
Parameters:
zipCode— string — Optional ZIP for market-specific pricing (defaults to LA rates if omitted).washFoldBags— number — Number of W&F bags. Each bag holds ~22 lb. Set to 0 if no W&F.washFoldPounds— number — Alternative to washFoldBags — total pounds for à-la-carte PAYG W&F pricing ($2.65/lb). Use one or the other, not both.dryCleaningItems— array — Dry-cleaning garments. Name each one in plain words; it is matched to Fold's garment list: Dress shirt, Blouse, Polo shirt, T-shirt, Tank top / cami, Scarf, Tie, Pants / slacks, Jeans, Skirt, Shorts, Sweater, Cardigan, Vest, Light jacket, Dress, Jumpsuit / romper, Blazer, Sport coat, Light coat / trench, Suit jacket (1 piece), 2-piece suit, 3-piece suit, Gown / formal dress, Tuxedo, Winter coat / parka, Leather jacket (light). Unrecognized names are returned in unmatchedItems instead of being priced.
Hints: read-only yes · destructive no · idempotent yes · open-world not declared
apply_promo_codedestructiveApply a promo / discount code to an existing order. Promo codes can only be applied to orders still in DRAFT or SCHEDULED state — before pickup. Requires order code, email, and the promo code (typically 4–12 alphanumeric, e.g. "WELCOME10" or "REF-AB12"). Returns the new total and the discount applied.
Parameters:
orderCode(required) — string — Order code (FHL-XXXXXX or FOLD-XXXXX).promoCode(required) — string — Promo code (case-insensitive), e.g. "WELCOME10".email— string — Email used at booking. Not needed when the customer has connected their Fold account.
Hints: read-only no · destructive yes · idempotent no · open-world not declared
list_campusesread-onlyList the campuses where Fold offers a Semester Pass (prepaid weekly laundry pickup for college students). Returns four campuses — UCLA, USC, UC Berkeley, UCSF — each with their available terms (e.g. "Fall 2026"), the weekly pickup day, and pricing for both weekly and bi-weekly cadence. buy_semester_pass takes a campusId and termId from this list. Prices are in USD.
Hints: read-only yes · destructive no · idempotent yes · open-world not declared
buy_semester_passdestructiveBuy a Fold Semester Pass for a college student at UCLA, USC, UC Berkeley, or UCSF. The PURCHASER (often a parent) provides their own name + email for the receipt, plus the student's name + email. Returns a Stripe Checkout URL — the purchaser must visit it to complete payment. Once paid, the student gets a separate email with an activation link to fill in their dorm details. campusId, termId and pricing come from list_campuses. Pricing varies by campus and term; the response echoes the priceCents.
Parameters:
campus(required) — string — Campus ID from list_campuses.termId(required) — string — Term ID from list_campuses (e.g. "fall_2026").frequency(required) — string — Pickup cadence. WEEKLY is the most common choice.studentFirstName(required) — string — Student first namestudentLastName(required) — string — Student last namestudentEmail(required) — string — Student email — .edu strongly preferred so the activation link reaches their school inboxpurchaserName(required) — string — Full name of the purchaser (parent/sponsor) — appears on the receiptpurchaserEmail(required) — string — Email of the purchaser — Stripe receipt + thank-you confirmation go hereisGift— boolean — Default true. Set false only if the purchaser IS the student.giftMessage— string — Optional short message displayed to the student in the activation email.idempotencyKey— string — OPTIONAL — UUID for safe retry. Identical keys return the EXISTING pass + checkout URL instead of creating a duplicate. Recommended for production agents.
Hints: read-only no · destructive yes · idempotent no · open-world yes
get_semester_passread-onlyLook up a Fold Semester Pass by code (FSP-XXXXXX). Returns current status, campus, term, dorm details (if claimed), and whether it's ready for pickups. Use this for "is my pass active yet?" or "what's the status of FSP-XXXXXX?" inquiries.
Parameters:
code(required) — string — Pass code (FSP-XXXXXX). Case-insensitive.
Hints: read-only yes · destructive no · idempotent yes · open-world not declared
activate_semester_passdestructiveActivate a paid Semester Pass — the student supplies their phone (for pickup-day reminders), dorm building + room, and their CHOSEN PICKUP DAY (one of the campus's availablePickupDays from list_campuses). Only callable on a pass in PENDING_ACTIVATION status (i.e. payment has cleared). After activation, weekly pickup Orders auto-generate on the chosen day until the term ends. Activation is idempotent — re-calling on an already-ACTIVE pass is a no-op.
Parameters:
code(required) — string — Pass code (FSP-XXXXXX).studentPhone(required) — string — Student phone in E.164 format (+1XXXXXXXXXX) or US 10-digit.dormBuilding(required) — string — Dorm building name (e.g. "Sproul Hall", "De Neve Plaza").dormRoom(required) — string — Room number (e.g. "412B").studentPickupDay(required) — integer — Pickup day of week — 0=Sun, 1=Mon, …, 6=Sat. Must be one of the campus's availablePickupDays from list_campuses.
Hints: read-only no · destructive yes · idempotent yes · open-world not declared
get_pricingread-onlyReturns current Fold pricing for all services. A quick rate-card overview; itemized totals for a specific order come from get_estimate. Prices are in USD.
Hints: read-only yes · destructive no · idempotent yes · open-world not declared
get_service_inforead-onlyReturns service area, hours, contact info, and key policies. Use this when the user asks "where do you serve?" or for a general overview.
Hints: read-only yes · destructive no · idempotent yes · open-world not declared
get_host_program_inforead-onlyReturns Fold's linen-turnover program for Airbnb / Vrbo / short-term rental hosts: how same-day turnovers work, pricing by host size (à la carte, Fold Club, portfolio volume rates), and how to get started. Use when the user hosts a short-term rental, manages STR properties, or asks about linen/turnover service between guests.
Hints: read-only yes · destructive no · idempotent yes · open-world not declared
get_referral_coderead-onlyLook up a customer's Fold referral code and share link. Use this when the customer wants to share Fold with a friend or check how many people they've successfully referred. Returns the code, a ready-to-paste link (foldlaundry.com/r/CODE), and stats. Both sides get $25 in credit after the friend completes their first pickup.
Parameters:
email(required) — string — Customer email used at Fold signup. Required.
Hints: read-only yes · destructive no · idempotent yes · open-world no
get_my_accountread-onlyOnly call this when the customer asks about their own Fold account, saved details or orders — it requires their connected Fold account and asks them to sign in. Prices, ZIP coverage, estimates and guest bookings work without signing in (get_pricing, check_service_zip, get_estimate, book_residential_pickup). Returns their saved addresses (with gate code / access notes), whether a card is on file, Fold credit balance, Fold Club membership, laundry care preferences (detergent, water temperature, special instructions) and recurring pickups. book_my_pickup uses these saved details.
Hints: read-only yes · destructive no · idempotent yes · open-world not declared
book_my_pickupdestructiveRequires the customer's connected Fold account. Books a pickup at one of their SAVED addresses using their saved card, gate code / access notes and laundry preferences — no payment link needed. Omit addressId to use their default address. pickupWindow must be one of the market's windows; if it is missing or invalid the response lists the valid windows and nothing is booked. Delivery is the next evening by default (Fold delivers in the evening only). sameAsLastOrder=true reuses the service, address and pickup window of the customer's most recent order (or of sameAsOrderCode, e.g. from a receipt); anything passed explicitly overrides it. This creates a real order. An optional idempotencyKey (UUID) makes retries return the same booking instead of creating a second one.
Parameters:
notes— string — Notes for THIS order only (e.g. "wine stain on white shirt"). Standing preferences are applied automatically.service— string — What to clean. Default WASH_AND_FOLD.addressId— string — One of the customer's saved addressIds (from get_my_account). Default: their default address.pickupDate— string — YYYY-MM-DD, today or later (Pacific time).deliveryDate— string — YYYY-MM-DD. Default: the day after pickup.pickupWindow— string — Pickup window label, e.g. "7:30 AM – 9:30 AM".deliveryWindow— string — Evening delivery window label. Default: the market's evening window.idempotencyKey— string — UUID recommended. Retrying with the same key returns the same booking.sameAsLastOrder— boolean — Reuse service, address and pickup window from the most recent order ("same as last time").sameAsOrderCode— string — Reuse service, address and pickup window from this specific past order (e.g. FOLD-24083).
Hints: read-only no · destructive yes · idempotent no · open-world yes
schedule_turnoversdestructiveRequires the connected Fold account. For short-term-rental hosts: schedules linen pickups for several guest checkouts at once across the host's saved addresses (up to 10). Each item: addressId (from get_my_account), checkoutDate (pickup day), pickupWindow, optional nextCheckInDate (return day; default the day after checkout) and notes. With confirm=false (default) nothing is booked: the response previews every item and flags problems. With confirm=true each valid item is booked as a real order on the card on file (same rules as book_my_pickup). Returns are in the evening; same-day turnovers rely on a second linen set at the property.
Parameters:
turnovers(required) — arrayconfirm— boolean — false (default) = preview only; true = book every valid item.idempotencyKey— string — UUID recommended. Retrying a confirmed call with the same key returns the same bookings.
Hints: read-only no · destructive yes · idempotent no · open-world yes
get_business_accountread-onlyRequires the connected Fold account, and only returns data when that login belongs to a Fold business (B2B) account such as a hotel, office or property-management company. For each such account: this month's deliveries and running total, the last three months' statement totals, payments, balance and due date, an open invoice payment link if one exists, and the scheduled delivery days. Read-only.
Hints: read-only yes · destructive no · idempotent yes · open-world not declared
update_care_preferencesdestructiveRequires the connected Fold account. Saves standing laundry preferences applied to every future order: detergent (eco_unscented = unscented eco, free & clear, the default; or tide), waterTemp (mixed = standard: colors cold, whites warm, the default; cold; warm; hot), and specialInstructions (free text the facility sees on every order, max 500 chars; pass an empty string to clear). Only the fields you pass change.
Parameters:
detergent— stringwaterTemp— stringspecialInstructions— string — e.g. "hang-dry activewear, no fabric softener". Empty string clears.
Hints: read-only no · destructive yes · idempotent yes · open-world not declared
update_access_infodestructiveRequires the connected Fold account. Saves how a driver gets in at one of the customer's saved addresses: gateCode (gate / building / lockbox code), howToGetIn (buzzer, doorman, side entrance), whereToLeaveBag. Drivers see these on every pickup and delivery there. Omit addressId for the default address. Pass an empty string to clear a field.
Parameters:
gateCode— string — Max 40 chars.addressId— stringhowToGetIn— string — Max 200 chars.whereToLeaveBag— string — Max 500 chars.
Hints: read-only no · destructive yes · idempotent yes · open-world not declared
update_notification_preferencesRequires the connected Fold account. Turns Fold's order-status text messages on or off (orderTexts: picked up, out for delivery, delivered; when off, the same updates arrive by email) and marketing emails on or off (marketingEmails). Only the fields passed change. Returns the resulting settings.
Parameters:
orderTexts— boolean — Order-status text messages on (true) or off (false).marketingEmails— boolean — Offers and news by email on (true) or off (false).
Hints: read-only no · destructive no · idempotent yes · open-world no
set_recurring_pickupdestructiveRequires the connected Fold account (with a saved address and card). Creates a standing pickup — e.g. every Tuesday — at the customer's default address. Fold books each pickup a few days ahead; the customer can skip or pause any time. This creates real recurring orders.
Parameters:
daysOfWeek(required) — array — e.g. ["TUE"]service— string — Default WASH_AND_FOLD.frequency— string — Default WEEKLY.
Hints: read-only no · destructive yes · idempotent no · open-world not declared
update_recurring_pickupdestructiveRequires the connected Fold account. action: pause (optionally until a YYYY-MM-DD date), resume, or cancel a recurring pickup (recurringId from get_my_account).
Parameters:
recurringId(required) — stringaction(required) — stringpauseUntil— string — YYYY-MM-DD (pause only). Omit to pause until resumed.
Hints: read-only no · destructive yes · idempotent yes · open-world not declared
report_issuedestructiveOpen a support case for an order (damaged / missing / wrong item, stain not removed, late delivery, re-clean, other). Works with the connected Fold account, or with order code + the email used at booking. A Fold specialist follows up by text or email; re-cleans are free. Describe what happened in the customer's words.
Parameters:
orderCode(required) — stringissueType(required) — stringdescription(required) — string — 10–2000 characters.email— string — Email used at booking. Not needed with a connected account.preferredResolution— string — Optional, e.g. "re-clean" or "refund for the shirt".
Hints: read-only no · destructive yes · idempotent no · open-world not declared
rate_orderRecords the customer's 1–5 star rating and optional comment for a delivered Fold order (rating again replaces the earlier one). Works with the connected account, or order code + booking email. For a high rating the response includes Fold's public review link the customer may choose to use; for a low rating it notes that report_issue opens a support case (re-clean, damage, missing item).
Parameters:
orderCode(required) — stringstars(required) — integeremail— string — Not needed with a connected account.comment— string — Optional, up to 500 characters, in the customer's words.
Hints: read-only no · destructive no · idempotent yes · open-world no
get_receiptread-onlyItemized receipt for an order: items, subtotal, fees, discounts, credits, tax and total, plus payment status. Before intake the items are not known yet and the total is an estimate. Works with the connected account, or order code + booking email.
Parameters:
orderCode(required) — stringemail— string — Not needed with a connected account.
Hints: read-only yes · destructive no · idempotent yes · open-world not declared
subscribe_order_updatesdestructiveFor agents that can receive webhooks: registers an https URL that Fold POSTs to on every status change of one order (picked up, washing, out for delivery, delivered…). Payload: {event:"order.status_changed", orderCode, state, statusLabel, statusDescription, occurredAt}. Header Fold-Signature: t=<unix>,v1=<hex HMAC-SHA256 of "t.body" with the returned secret>. Works with the connected account or order code + booking email. Max 3 per order.
Parameters:
orderCode(required) — stringwebhookUrl(required) — string — Public https URL.email— string — Not needed with a connected account.
Hints: read-only no · destructive yes · idempotent yes · open-world yes
book_for_hotel_guestdestructiveRequires the connected Fold account of front-desk staff at a Fold partner hotel (the login must belong to the hotel's Fold business account). Books laundry pickup for a guest by room number at that hotel. billTo='hotel' (default) puts the order on the hotel's monthly Fold statement so the hotel can charge the guest's folio: no card link is sent and no card is charged. billTo='guest' sends the guest the usual card link instead and is priced at the hotel guest rates (see book_hotel_pickup); billTo='hotel' orders are priced on the hotel's Fold contract rates, with the same $49.99 hotel order minimum. Guest name, email and phone are still needed for status updates. returnPreference: same_day (bag at the desk before 9 AM), express_same_day (9 AM–noon, +$30), next_day, or flexible. This creates a real order.
Parameters:
roomNumber(required) — stringguestFirstName(required) — stringguestLastName(required) — stringguestEmail(required) — string — For order status updates and the receipt.guestPhone(required) — string — E.164 or US 10-digit, for pickup/delivery texts.services(required) — arrayreturnPreference(required) — stringnotes— string — For this order only, e.g. "2 dress shirts on hangers, rush for 6 PM event".billTo— string — Default 'hotel' (on the hotel's monthly statement).idempotencyKey— string — UUID recommended. Retrying with the same key returns the same booking.hotelAccountName— string — Only needed if this login belongs to more than one partner hotel.
Hints: read-only no · destructive yes · idempotent no · open-world yes
Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.