{"name":"hookware","title":"Business knowledge and identity","version":"0.1.0","description":"Knowledge and identity for one business (its facts, documents, tone, skills and memory), and the family tools its assistants use (drafts and requests; the owner approves).","vendor":"Parent Vertical LLC","endpoints":{"mcp":"https://api.hookvak.com/mcp","llms":"https://api.hookvak.com/llms.txt"},"transport":{"type":"streamable-http","protocolVersion":"2025-06-18"},"authentication":{"type":"bearer","header":"Authorization","oauth":"passvak","scopes":"hookware:<tool>"},"tools":[{"name":"retrieve_knowledge","description":"Search the business's knowledge (documents it uploaded) for passages that answer a question."},{"name":"get_business_facts","description":"The business's own facts: name, hours and its questions with answers (what the front desk answers from)."},{"name":"get_identity","description":"How the business speaks: name, tone, greeting and values."},{"name":"list_documents","description":"Documents in the business's knowledge, with their status."},{"name":"discover_skills","description":"What this business's assistant can do (skills), by category or tag."},{"name":"remember_context","description":"Save a note to the business's memory (events, facts or how-tos)."},{"name":"recall_context","description":"Find notes in the business's memory."},{"name":"get_status","description":"Who the caller is, the business's plan and whether it is on, and the service health."},{"name":"get_usage","description":"AI conversations used against the plan: { month, used, quota, resets_at }."},{"name":"list_plans","description":"Plans with id, price_usd and limits (EN + ES labels)."},{"name":"upgrade_plan","description":"The payment body (checkout_url, status_url) for the owner to approve. Agents never pay."},{"name":"create_api_key","description":"A key scoped to the caller. Needs the owner's sign-in token (not enabled here yet)."},{"name":"find_contact","description":"Find the business's clients by name, phone or email (q), or count them: leave q out and read `total` (\"how many clients do I have?\"). The answer always has `total` (the matches) and the tags in use. (Family tool: drafts and requests only; the owner approves.)"},{"name":"find_or_add_contact","description":"Find a customer by phone or email, or add them (name, language, a parent's link to their teen with guardian_of). (Family tool: drafts and requests only; the owner approves.)"},{"name":"record_consent","description":"Record that the customer said YES to messages (only when they clearly said so; evidence = their exact words). On the owner's word, a yes to promotions waits for the owner's OK. (Family tool: drafts and requests only; the owner approves.)"},{"name":"find_slots","description":"Open times for a service, a staff member or a room (at most 14 days). (Family tool: drafts and requests only; the owner approves.)"},{"name":"list_classes","description":"Class meetings with seats left and the waitlist. (Family tool: drafts and requests only; the owner approves.)"},{"name":"book","description":"Book an appointment, a class seat, a room or tickets. Pending until the business confirms (unless it auto-confirms). (Family tool: drafts and requests only; the owner approves.)"},{"name":"cancel_booking","description":"Cancel a booking (the business's cutoff applies). (Family tool: drafts and requests only; the owner approves.)"},{"name":"reschedule_booking","description":"Move a booking to another time (the cutoff applies). (Family tool: drafts and requests only; the owner approves.)"},{"name":"join_waitlist","description":"Put the customer on a full class's waitlist (first in, first out). (Family tool: drafts and requests only; the owner approves.)"},{"name":"list_bookings","description":"The business's bookings between two dates (who is booked when). (Family tool: drafts and requests only; the owner approves.)"},{"name":"get_booking","description":"One booking: its time and status. (Family tool: drafts and requests only; the owner approves.)"},{"name":"create_link","description":"A short link to pay, sign a waiver, book or chat (https, on the business's allowed hosts). A chat link with no end date is a draft for the owner. (Family tool: drafts and requests only; the owner approves.)"},{"name":"draft_item","description":"Draft a new event, class time, price, announcement, hours, FAQ or page block. (Family tool: drafts and requests only; the owner approves.)"},{"name":"draft_hours","description":"Draft the week's hours in one call (\"Mon-Fri 9-6, closed Sunday\"): one change for one owner OK. Each day: weekday mon-sun with opens and closes (HH:MM), or closed true. (Family tool: drafts and requests only; the owner approves.)"},{"name":"update_draft","description":"Change a draft (the owner still approves it). (Family tool: drafts and requests only; the owner approves.)"},{"name":"list_items","description":"The business's website items and their draft and live versions: hours, FAQs and the rest. (Family tool: drafts and requests only; the owner approves.)"},{"name":"preview_link","description":"A private preview link of a draft for the owner. (Family tool: drafts and requests only; the owner approves.)"},{"name":"draft_broadcast","description":"Draft a message to the customers who said yes (update or offer). The owner approves before anything is sent. (Family tool: drafts and requests only; the owner approves.)"},{"name":"preview_audience","description":"How many customers who said yes a message would reach. (Family tool: drafts and requests only; the owner approves.)"},{"name":"send_email","description":"Email a customer who asked for it (they must have said yes to email). Sent as the business. (Family tool: drafts and requests only; the owner approves.)"},{"name":"create_checkout_link","description":"A payment link for a deposit or a ticket, paid to the business's own account. (Family tool: drafts and requests only; the owner approves.)"},{"name":"search_domain","description":"Check which web addresses (domains) are free, with their yearly price. (Family tool: drafts and requests only; the owner approves.)"},{"name":"connect_calendar","description":"A link for the owner to connect their own calendar (confirmed bookings appear there). Nothing is connected until the owner agrees on that page. (Family tool: drafts and requests only; the owner approves.)"},{"name":"post_to_social","description":"One draft, many places: a website event or announcement (a draft or already live) for the website, the business listing, Facebook, Instagram and YouTube (with the video the owner sent). The owner approves once; nothing is public before that. (Family tool: drafts and requests only; the owner approves.)"},{"name":"list_reviews","description":"The business listing's newest reviews (rating, text, language, answered or not). (Family tool: drafts and requests only; the owner approves.)"},{"name":"draft_review_reply","description":"Draft a short, polite reply to one review in the reviewer's language (no discounts or promises unless the owner allows them; a 1-2 star review: calm, sorry, invite them to text). Posted only after the owner approves. (Family tool: drafts and requests only; the owner approves.)"},{"name":"golive_check_domain","description":"Step 1: is the address the business's and pointed here? If not, an offer: buy it (free names, price shown) or bring it (bring: true gives the two name servers to set). (Family tool: drafts and requests only; the owner approves.)"},{"name":"golive_dry_run","description":"Step 2, read only: READY, or what is still missing, and what going live will do. (Family tool: drafts and requests only; the owner approves.)"},{"name":"golive_deploy_site","description":"Put the website on the address (public). The first call asks the owner (waiting_for_owner + approval_id); nothing is public until the owner says OK. (Family tool: drafts and requests only; the owner approves.)"},{"name":"golive_verify","description":"Last step: the live checks from outside (pages, www, safety). All green = live. (Family tool: drafts and requests only; the owner approves.)"},{"name":"golive_status","description":"Where going live stands (\"3 of 5 done …\"), pending approvals and secret states. (Family tool: drafts and requests only; the owner approves.)"},{"name":"golive_secret_request","description":"A one-time secure link (10 minutes) where the OWNER types a secret by name. Never send or accept the value. (Family tool: drafts and requests only; the owner approves.)"},{"name":"get_progress","description":"One customer's loyalty standing: each program's count and how many to go (with words to tell them), rewards ready to use and their referral code. (Family tool: drafts and requests only; the owner approves.)"},{"name":"list_programs","description":"The business's loyalty programs (punch cards, points, referrals) and their rewards. (Family tool: drafts and requests only; the owner approves.)"},{"name":"add_visit","description":"Record one visit by hand (bookings count on their own; give booking_id so it never counts twice). At most one manual visit per person per day from an assistant. (Family tool: drafts and requests only; the owner approves.)"},{"name":"get_referral_code","description":"A customer's referral code and link to share (made once, kept). (Family tool: drafts and requests only; the owner approves.)"},{"name":"record_referral","description":"A new customer came with someone's code (before their first visit; nobody refers themselves; one per person). (Family tool: drafts and requests only; the owner approves.)"},{"name":"list_devices","description":"The business's devices: state, location, last check-in, battery, lock. (Family tool: drafts and requests only; the owner approves.)"},{"name":"get_device","description":"One device with its history (assignment, setup, locks, check-ins). (Family tool: drafts and requests only; the owner approves.)"},{"name":"request_device","description":"Ask for devices (\"I want 2 handhelds\"): a model or a form, 1-20, where. From an assistant it is a draft the owner approves; nothing is charged here. (Family tool: drafts and requests only; the owner approves.)"},{"name":"check_message","description":"Check a reply before it goes out: verdict allow, allow_with_disclaimer or block, a masked safe copy and the disclaimer to add. Never send a blocked reply; add the disclaimer when asked. (Family tool: drafts and requests only; the owner approves.)"},{"name":"mask_pii","description":"A copy of a text with personal data masked (phones, emails, cards, ids, birth dates, addresses). Nothing is stored. (Family tool: drafts and requests only; the owner approves.)"},{"name":"get_disclaimers","description":"The disclaimers this business must add on a channel (EN/ES). (Family tool: drafts and requests only; the owner approves.)"},{"name":"who_is_working","description":"\"Who's working Saturday?\": the shifts on one day, with staff ids and state. (Family tool: drafts and requests only; the owner approves.)"},{"name":"who_is_late","description":"\"Who's late?\": shifts started with nobody clocked in, and who came in late today. (Family tool: drafts and requests only; the owner approves.)"},{"name":"list_shifts","description":"Published shifts in a range (default the next 7 days), each with its state. (Family tool: drafts and requests only; the owner approves.)"},{"name":"my_shifts","description":"The team member's own shifts (default the next 7 days), each with its id and state. (Family tool: drafts and requests only; the owner approves.)"},{"name":"request_time_off","description":"The team member asks for days off (local dates, inclusive); the owner decides. (Family tool: drafts and requests only; the owner approves.)"},{"name":"offer_swap","description":"The team member offers one of their shifts, to one person (to_staff_id) or anyone. (Family tool: drafts and requests only; the owner approves.)"},{"name":"accept_swap","description":"The team member takes a shift someone offered; the owner approves it. (Family tool: drafts and requests only; the owner approves.)"},{"name":"clock_link","description":"A link for one of the team member's own shifts to clock in and out. (Family tool: drafts and requests only; the owner approves.)"},{"name":"draft_entry","description":"Propose a books entry from what the owner said (\"I paid $40 cash for supplies\" → expense, amount \"40\", cash, supplies). Not in the books until the owner approves it. Card payments arrive on their own. (Family tool: drafts and requests only; the owner approves.)"},{"name":"list_entries","description":"The books, newest first (from/to, kind, method, category, contact; drafts: true adds the drafts waiting for the owner). (Family tool: drafts and requests only; the owner approves.)"},{"name":"pnl","description":"Profit and loss for a month or a quarter, in cents. (Family tool: drafts and requests only; the owner approves.)"},{"name":"report","description":"A books report: income_by_method, unmatched (card payouts with no payment), aging. (Family tool: drafts and requests only; the owner approves.)"},{"name":"list_categories","description":"The business's chart of accounts (EN + ES names). (Family tool: drafts and requests only; the owner approves.)"},{"name":"waivers_who_needs_to_sign","description":"\"Who hasn't signed?\": for a class meeting (class_id + date from list_classes), for contact_ids, or (nothing given) everyone booked in the next days. Answers who signed, who still needs to (never signed, expired, a new version) with names, and who expires soon. (Family tool: drafts and requests only; the owner approves.)"},{"name":"waivers_send","description":"Text the waiver link. To one person (contact_id): sent now. To two or more (contact_ids, or class_id + date) it is a draft until the owner says OK. The front desk sends only to the person it is talking to. (Family tool: drafts and requests only; the owner approves.)"},{"name":"waivers_create_link","description":"A one-time link for ONE person to sign the waiver on their phone (1-7 days). Nothing is sent: give it to them. short: true gives a short link. (Family tool: drafts and requests only; the owner approves.)"},{"name":"waivers_list_signatures","description":"Signed waivers: who (contact id), which version, when, until when. Filter by template, contact, from/to. (Family tool: drafts and requests only; the owner approves.)"},{"name":"directory_get_listing","description":"The business's public listing as the owner sees it: listed or not, which parts are public, any draft waiting, the addresses, and every YES and take-down. (Family tool: drafts and requests only; the owner approves.)"},{"name":"directory_get_traffic","description":"How many anonymous reads the listing had, per day. (Family tool: drafts and requests only; the owner approves.)"},{"name":"directory_publish_snapshot","description":"Prepare the listing's facts. Not listed: kept as a private draft. Listed: a change waiting for the owner's OK. Never public by itself. (Family tool: drafts and requests only; the owner approves.)"},{"name":"directory_request_listing","description":"Ask the owner whether to go on the public listing, with these parts. It lists nothing: the owner's OK does. (Family tool: drafts and requests only; the owner approves.)"},{"name":"catalog_public_products","description":"The products this business chose to show customers, with prices and whether each is in stock (yes or no). (Family tool: drafts and requests only; the owner approves.)"},{"name":"catalog_list_products","description":"Every product with its variants and prices (status, category). (Family tool: drafts and requests only; the owner approves.)"},{"name":"catalog_get_product","description":"One product with its variants, prices and whether it is publicly listed. (Family tool: drafts and requests only; the owner approves.)"},{"name":"catalog_get_stock","description":"How many are on hand, per variant and place. (Family tool: drafts and requests only; the owner approves.)"},{"name":"catalog_low_stock","description":"Items at or below their low-stock mark, lowest first. (Family tool: drafts and requests only; the owner approves.)"},{"name":"catalog_list_sales","description":"Sales, newest first (status: awaiting_payment, paid, cash, returned). (Family tool: drafts and requests only; the owner approves.)"},{"name":"catalog_list_drafts","description":"Changes waiting for the owner's OK. (Family tool: drafts and requests only; the owner approves.)"},{"name":"catalog_draft_change","description":"Draft a change for the owner's OK; nothing happens until then. kind: product_create, product_update, variant_add, variant_update, price_change, stock_adjust, sale, return or listing. changes: that change's details (variant_id, price_cents, lines, ...). It is checked now, so a bad draft is refused here. (Family tool: drafts and requests only; the owner approves.)"},{"name":"catalog_import_preview","description":"Check a product list (CSV, product and price columns in English or Spanish) and say what it would change. It changes nothing: the owner's OK adds it. (Family tool: drafts and requests only; the owner approves.)"},{"name":"tickets_open","description":"Open a support ticket for a customer's problem: subject in one line, their words in text. The front desk opens it only for the person it is talking to, once it knows who they are. (Family tool: drafts and requests only; the owner approves.)"},{"name":"tickets_list","description":"Tickets, newest first (status, priority, contact_id, overdue). (Family tool: drafts and requests only; the owner approves.)"},{"name":"tickets_get","description":"One ticket: what the customer said, the replies (drafts too) and the private notes. (Family tool: drafts and requests only; the owner approves.)"},{"name":"tickets_add_note","description":"A private note on a ticket. Never sent to the customer. (Family tool: drafts and requests only; the owner approves.)"},{"name":"tickets_draft_reply","description":"Draft a reply to the customer. It goes nowhere until the owner says OK. (Family tool: drafts and requests only; the owner approves.)"},{"name":"tickets_status_reply","description":"A plain status reply in fixed words (status_word). A draft for the owner's OK unless the owner turned these on. (Family tool: drafts and requests only; the owner approves.)"},{"name":"tickets_summarize","description":"The facts of a ticket to write a summary from; summary saves your words as a private note. (Family tool: drafts and requests only; the owner approves.)"},{"name":"ads_list_campaigns","description":"The owner's ad campaigns across their accounts: status, budget, this month's spend in cents. (Family tool: drafts and requests only; the owner approves.)"},{"name":"ads_get_pacing","description":"Each campaign against its budget, and the month against the owner's limit. (Family tool: drafts and requests only; the owner approves.)"},{"name":"ads_list_recommendations","description":"Suggestions about the ads, each with its numbers, how sure it is and what happens if it is wrong. (Family tool: drafts and requests only; the owner approves.)"},{"name":"ads_propose_change","description":"Draft one change for the owner: pause_campaign, pause_ad, start_campaign, set_budget (daily_budget_cents or lifetime_budget_cents), add_negative_keywords, pause_rule, set_platform_cap. reason in English and Spanish, or recommendation_id. Nothing changes until the owner's OK. (Family tool: drafts and requests only; the owner approves.)"},{"name":"ads_draft_boost","description":"Draft turning one of the owner's own posts into a paid ad: daily budget, 2 to 30 days, a country, and the ad category answer (NONE unless housing, employment, credit, politics, gambling or financial). Nothing is spent until the owner's OK. (Family tool: drafts and requests only; the owner approves.)"},{"name":"booking_info","description":"For a customer: the public booking page (when it is on), deposits, the cancellation cutoff and the no-show and late-cancel policy in the owner's words. (Family tool: drafts and requests only; the owner approves.)"},{"name":"get_booking_page","description":"The self-booking settings: page on or off, what it offers, deposits, the fee policy, the link, and what still needs setting up. The owner changes them in settings. (Family tool: drafts and requests only; the owner approves.)"},{"name":"list_fees","description":"No-show and late-cancel fees: draft (waiting for the owner), approved, declined, paid. (Family tool: drafts and requests only; the owner approves.)"},{"name":"mark_no_show","description":"Mark a booking as a no-show, 15 minutes after its start or later. If the customer agreed to the fee policy a fee is drafted; nothing is charged until the owner says OK. (Family tool: drafts and requests only; the owner approves.)"},{"name":"get_automation_settings","description":"Whether automations and the lapsed and birthday audiences are on. (Family tool: drafts and requests only; the owner approves.)"},{"name":"list_automations","description":"The saved win-back and birthday automations: words, next run, and whether each asks every time. (Family tool: drafts and requests only; the owner approves.)"},{"name":"get_automation","description":"One automation with its last runs and its auto-send decisions. (Family tool: drafts and requests only; the owner approves.)"},{"name":"get_lifecycle_settings","description":"Whether birthdays, last visits and surveys are on, and their settings. (Family tool: drafts and requests only; the owner approves.)"},{"name":"set_contact_birthday","description":"Save a client's birthday as the owner gave it: month and day only, like 03-15, never a year. Empty clears it. (Family tool: drafts and requests only; the owner approves.)"},{"name":"birthdays_soon","description":"Who has a birthday in the next days (default 7, at most 31) and said yes to promotions on this channel. (Family tool: drafts and requests only; the owner approves.)"},{"name":"client_ratings","description":"Survey answers, newest first: score 1-5 and the private comment. low: true for the low scores. For the owner only. (Family tool: drafts and requests only; the owner approves.)"},{"name":"waivers_list_documents","description":"Contracts and proposals sent: open, signed, declined, expired or revoked, whether opened, the total. (Family tool: drafts and requests only; the owner approves.)"},{"name":"waivers_list_templates","description":"The business's waivers, contracts and proposals that can be sent. (Family tool: drafts and requests only; the owner approves.)"},{"name":"waivers_list_invoice_drafts","description":"Invoice drafts from accepted proposals: pending, approved or declined. (Family tool: drafts and requests only; the owner approves.)"}]}