{"id":"com.commontape/booking","slug":"com-commontape-booking","title":"CommonTape","description":"Quote, hold and book US house cleaning jobs on a customer's behalf, at each business's own prices.","version":"1.2.0","publisher":{"kind":"domain","id":"commontape.com","label":"commontape.com","url":"https://commontape.com"},"website":"https://commontape.com/docs","repository":"","remotes":[{"type":"streamable-http","url":"https://commontape.com/api/mcp","headers":[{"description":"Bearer <your key>. Get your own key with POST https://commontape.com/api/v1/keys (or this server's register tool): shown once, starter limits raised by email. Without it the server still lists its tools and answers register, taxonomy and a search without quote tokens. To try it with no sign-up, use the demo key: Bearer ct_demo_nQz4WaXqJvMoL8A6FYCaRtpJnsF7UrZh (reaches only a pretend business in ZIP 10001, never a real one).","isSecret":true,"name":"Authorization"}]}],"packages":[],"published":"2026-10-13","updated":"2026-10-13","status":"online","auth":"","latency_ms":935,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"search","title":"","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 confirm","read_only":false},{"name":"discover","title":"","description":"Describe one merchant: services with pricing_model (packages: each package with its price, limits, kinds and the tasks it includes; the price is the cheapest package that fits the whole home and does every must-have task), typed inputs (incl. its answer for every job condition: no_charge, extra_charge with amount, ask_first, not_taken, not_answered), add-ons and passport (what each service covers,","read_only":false},{"name":"quote","title":"","description":"Quote one merchant's service. Every quote is a record: it returns transaction_id, quote_id, job_version and state quoted (or quote_incomplete). Pass transaction_id to quote the same job again (its next version; everything asked for before is carried forward); on a booked job that quote is the change modify commits. A job that ended is never revived: quoting it starts a new job. Search already retu","read_only":false},{"name":"hold","title":"","description":"Reserve one window from a quote: the quoted job becomes held (same transaction_id). An expired or replaced quote answers QUOTE_EXPIRED: quote again. M-19: pick a window of the quote's job_hours; a window of another length, or one no longer in the business's hours, answers OUTSIDE_HOURS. M-19b: the hold counts the job's cleaners (job_people) against the business's cleaners in all and keeps its time","read_only":false},{"name":"book","title":"","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","read_only":false},{"name":"modify","title":"","description":"Commit a change to a booked job: first quote it again with its transaction_id, then modify with that quote_token, optionally moving it to another window. The job stays booked; the old version and price are kept. The answer and every refusal carry change: kinds (capacity, commercial, eligibility, approval, non_commercial), rechecked, price from and to; a refused change leaves the booked job as it w","read_only":false},{"name":"cancel","title":"","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 of","read_only":false},{"name":"status","title":"","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), completio","read_only":false},{"name":"taxonomy","title":"","description":"The fixed word list (version, groups, every key with its label and synonyms) agents use to describe a job and a home. Public, no key; the same answer as GET /api/v1/taxonomy/house_cleaning. Word list version 6.","read_only":false},{"name":"register","title":"","description":"Get your own key, no human needed. Send agent_name (what your agent is called), owner_label (the plain name business owners will see next to a job, 1-40 characters) and contact_email. The key (ct_live_...) is in the answer ONCE: keep it and send it as Authorization: Bearer <key>. Starter limits: 30 requests a minute, 3 open holds, 5 bookings a day; the email sent to contact_email carries a link th","read_only":false}],"server_info":{"name":"commontape","version":"1.0.0"},"category":"hr","tags":["support","finance","web-search"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-05","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/com-commontape-booking/"}