{"serverId":"mcp-registry/com.commontape/booking","tools":[{"name":"book","fixed":{"name":"book","description":"Commit a hold with the customer's details. Returns booked, or pending_approval (the owner must say yes: the quote's booking_authority was approval_required, or the owner's booking setting tightened since; the time stays reserved; poll status until decide_by, about once a minute: the owner has up to 2 hours, never later than an hour before the job (a job starting within about an hour keeps its hold's time); jobs waiting count toward your open holds; with no answer by then the job is expired: the ","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["transaction_id","customer","idempotency_key"],"properties":{"customer":{"type":"object","required":["name","phone","service_address"],"properties":{"name":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"service_address":{"type":"string"},"access_instructions":{"type":"string","maxLength":500,"description":"How the cleaner gets in (gate or door code, where the key or lockbox is). Shown to the owner only after they say yes; never returned to you."}}},"transaction_id":{"type":"string","description":"transaction_id from quote or hold"},"idempotency_key":{"type":"string","description":"Unique per write request (a UUID). Retrying with the same key returns the original result."}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":371,"tokensAfter":371},{"name":"cancel","fixed":{"name":"cancel","description":"Cancel your own held, waiting (pending_approval) or booked job and release the slot. Optional reason: customer_changed_plans, customer_booked_elsewhere, booked_in_error, customer_other. The answer carries cancellation (by, at, reason, fee null, policy, capacity_released): CommonTape takes no cancellation fee. Already cancelled answers ALREADY_CANCELLED (with recovery when the business called it off).","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["transaction_id","idempotency_key"],"properties":{"reason":{"enum":["customer_changed_plans","customer_booked_elsewhere","booked_in_error","customer_other"],"type":"string"},"transaction_id":{"type":"string","description":"transaction_id from quote or hold"},"idempotency_key":{"type":"string","description":"Unique per write request (a UUID). Retrying with the same key returns the original result."}}},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":260,"tokensAfter":260},{"name":"search","fixed":{"name":"search","description":"Start here. Every result carries trust (facts with who vouches for each and until when, lapsed facts, the job record); trust never changes the order, the price, who is eligible or what needs approval. A search result is not a promise: prices and windows are as of availability_checked_at, and only a booked job is committed. Every business line carries facts_confirmed_at (when its owner last confirmed its facts: a save, CommonTape's switch-on or a Yes on the daily email; null if never), stale (tru","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["zip"],"properties":{"zip":{"type":"string","description":"The customer's 5-digit US ZIP"},"scope":{"type":"object","properties":{"leave_out":{"type":"array","items":{"type":"string"}},"clean_only":{"type":"array","items":{"type":"string"}}},"description":"The rooms the job covers: leave_out (rooms not to clean) or clean_only (the only rooms to clean), never both, by space.* key. Under a by_rooms price a room left out comes off the price; other prices do not change. Echoed on every answer and shown to the owner.","additionalProperties":{}},"inputs":{"type":"object","properties":{"hours":{"type":"number"},"addons":{"type":"array","items":{"type":"string"},"description":"Task keys the customer must have, e.g. task.fridge_interior; each is priced in, or included by the package quoted."},"people":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"bedrooms":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"bathrooms":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"frequency":{"enum":["once","weekly","biweekly","monthly"],"type":"string"},"conditions":{"type":"array","items":{"type":"string"}},"quantities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991}},"surcharges":{"type":"array","items":{"type":"string"}},"square_feet":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"customer_zip":{"type":"string"}},"description":"The job's price inputs: hours, people, frequency, conditions, and bedrooms, bathrooms, square_feet when not stated in property. Each service uses only what its price needs.","additionalProperties":{}},"must_not":{"type":"array","items":{"type":"string"},"description":"Tasks to leave out, a way to pay the customer cannot use, or crew.solo."},"property":{"type":"object","properties":{"size":{"type":"object","required":["square_feet"],"properties":{"approximate":{"type":"boolean"},"square_feet":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991}},"additionalProperties":{}},"type":{"type":"string","description":"Kind of home: property.studio | property.apartment | property.condo | property.townhouse | property.detached_house | property.duplex | property.villa | property.other_residential"},"floors":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"description":"Floors inside the home"},"spaces":{"type":"object","description":"space.* key -> how many, e.g. {\"space.bedroom\": 2, \"space.bathroom.full\": 2, \"space.bathroom.half\": 1}. A room that exists is a fact, not a request to clean it.","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991}},"occupancy":{"type":"string","description":"occupied | vacant"},"furnishing":{"type":"string","description":"furnished | partly_furnished | unfurnished"},"floor_level":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"description":"Floor of the home's front door; street level = 1, below it = 0"}},"description":"The home, stated once with the words at /api/v1/taxonomy/house_cleaning (property). Unknown or unclear words are refused with the word meant or the question to ask. Bedrooms, bathrooms (when there is no half bathroom) and square feet feed each price that uses them; no need to repeat them in inputs. A by_rooms price and a fixed price's limits read property.spaces only (state every kind the price counts, 0 included; a living area is living + family + formal living rooms).","additionalProperties":{}},"arrive_by":{"type":"string","description":"Optional. The latest start: a date and time like 2026-10-09T10:00 (wall clock in the job ZIP's time zone, the business's zone) or with an offset (2026-10-09T14:00Z). Only windows that start by then are offered; none left is a near miss no_window_fits. Refused: a time that does not exist (clocks going forward), the past, more than 60 days ahead."},"finish_by":{"type":"string","description":"Optional. The latest finish, written like arrive_by: a window is offered only if it starts early enough to end by then (window start plus job_hours, else the window's end). After arrive_by when both are sent."},"max_total":{"type":"number","description":"Optional. The most the customer will pay in all, in dollars (travel and extra charges included). A priced business above it is a near miss over_max_total with the gap in dollars; a window whose own day or hour charge would take the price over it is left out; a business with no price yet (needs_more, owner_must_quote) is listed with max_total not_checked in statuses."},"must_have":{"type":"array","items":{"type":"string"},"description":"Words the business must offer, e.g. task.fridge_interior, pay.card. Tasks at extra cost, or done only inside a package, are priced in."},"service_key":{"type":"string","description":"house_cleaning.standard | house_cleaning.deep | house_cleaning.move_in_out. Omit to consider all three."},"customer_ref":{"type":"string","pattern":"^[A-Za-z0-9._:-]{1,64}$","description":"Optional. Your own label for your customer, so two customers with the same job are not the same job. Never shown to the owner."},"nice_to_have":{"type":"array","items":{"type":"string"},"description":"Words that rank a business higher but never exclude it."},"special_requests":{"type":"array","items":{"type":"string"},"description":"Up to 5 plain-text requests not on the word list. Always needs the owner's approval."},"id_to_security_hours_before":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"description":"Optional, with cond.id_to_security in inputs.conditions. How many hours before the job the building wants each cleaner's name and photo ID (1 to 168). A business that can send them at least this far ahead meets it; one that cannot is a near miss id_notice_too_short; one that has not said is not_said in statuses."}},"additionalProperties":{}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":1855,"tokensAfter":1855},{"name":"status","fixed":{"name":"status","description":"The authoritative state of one of your jobs and everything needed to act on it: the job (current version), price, quote, window, approval (what needs the owner's yes and why: reasons, the deadline, what happens at it), commitment (who committed the booking: the owner's rule or the owner; your call is your assertion for your customer), decline (reason, code, next_actions, next_available), completion (who marked it done), cancellation (who, when, why, no fee), receipt (what was booked, from the re","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["transaction_id"],"properties":{"transaction_id":{"type":"string","description":"transaction_id from quote or hold"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":208,"tokensAfter":208}],"toolsChanged":4,"tokensSaved":0,"todo":[{"tool":"book","params":["customer"]},{"tool":"cancel","params":["reason"]},{"tool":"discover","params":["merchant_slug"]},{"tool":"hold","params":["quote_token","allocation_id"]},{"tool":"modify","params":["quote_token","new_allocation_id"]},{"tool":"quote","params":["inputs","service_key","merchant_slug"]}],"note":"Deterministic fixes. Changes marked verify need a human look before shipping (renames, inferred annotations, inferred types, removed text). Parameter descriptions in `todo` need to be written by someone who knows the API."}