# Business knowledge and identity (CelVak family) > What one business knows and how it speaks, for agents: its hours and answers, its documents, its tone, > its skills and a small memory. By Parent Vertical LLC. ## English Ask what a business knows before answering for it: get_business_facts gives its hours and its own answers, retrieve_knowledge searches its documents, get_identity says how it speaks. Every call is for one business. While a business is off (not paid, or its trial ended), tools answer payment_required with a link the owner approves; agents never pay. ## Español Pregunta lo que sabe un negocio antes de responder por él: get_business_facts da su horario y sus propias respuestas, retrieve_knowledge busca en sus documentos, get_identity dice cómo habla. Cada llamada es para un solo negocio. Mientras un negocio está apagado (sin pagar, o terminó su prueba), las herramientas responden payment_required con un enlace que aprueba el dueño; los agentes nunca pagan. ## Family tools / Herramientas de la familia EN: The assistants' tools (contacts and consent, bookings, links, website drafts, group-text drafts, email to someone who asked, payment links, domain search, loyalty and referrals, the business's devices, putting the website on its own address, the message rules check, who's working and a team member's own shifts, books drafts and reports, who still needs to sign a waiver and the waiver link, the public listing, products and stock, support tickets, the booking page and fees, automations, birthdays, contracts and proposals) are here too. Each is one call to a family service; agents only draft or request, and the owner approves anything public, sent to a group or paid. Pass agent (front_desk or owner_assistant). ES: Las herramientas de los asistentes (contactos y consentimiento, reservas, enlaces, borradores para la página y para mensajes a grupos, correo a quien lo pidió, enlaces de pago, búsqueda de dominios, lealtad y recomendaciones, los equipos del negocio, poner la página en su propia dirección, la revisión de las reglas de mensajes, quién trabaja y los turnos propios de alguien del equipo, borradores e informes de los libros, quién aún necesita firmar una exención y el enlace para firmarla, la ficha pública, productos e inventario, casos de soporte, la página de reservas y los cargos, automatizaciones, cumpleaños, contratos y propuestas) también están aquí. Cada una es una llamada a un servicio de la familia; los agentes solo preparan o solicitan, y el dueño aprueba todo lo público, lo que va a un grupo o lo que cuesta dinero. Indica agent (front_desk u owner_assistant). ## Agents / Agentes - A2A Agent Card (owner assistant, flyer reader, front desk, voice): https://api.hookvak.com/.well-known/agent-card.json - A2A JSON-RPC 2.0 (message/send, message/stream, tasks/get, tasks/cancel): https://api.hookvak.com/a2a ## Use - MCP (2025-06-18, streamable HTTP): https://api.hookvak.com/mcp - Auth: Authorization: Bearer , or the platform's internal secret naming the business. Agent sign-in (passvak OAuth, when switched on): a token for this service or the family gateway, naming the business, with hookware: / hookware: scopes; outside assistants also need the owner's grant. - Limits: { "error": "payment_required", "checkout_url", "approve_by": "human", "message": { "en", "es" } }. ## Tools - retrieve_knowledge: Search the business's knowledge (documents it uploaded) for passages that answer a question. - get_business_facts: The business's own facts: name, hours and its questions with answers (what the front desk answers from). - get_identity: How the business speaks: name, tone, greeting and values. - list_documents: Documents in the business's knowledge, with their status. - discover_skills: What this business's assistant can do (skills), by category or tag. - remember_context: Save a note to the business's memory (events, facts or how-tos). - recall_context: Find notes in the business's memory. - get_status: Who the caller is, the business's plan and whether it is on, and the service health. - get_usage: AI conversations used against the plan: { month, used, quota, resets_at }. - list_plans: Plans with id, price_usd and limits (EN + ES labels). - upgrade_plan: The payment body (checkout_url, status_url) for the owner to approve. Agents never pay. - create_api_key: A key scoped to the caller. Needs the owner's sign-in token (not enabled here yet). - find_contact: 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.) - find_or_add_contact: 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.) - record_consent: 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.) - find_slots: Open times for a service, a staff member or a room (at most 14 days). (Family tool: drafts and requests only; the owner approves.) - list_classes: Class meetings with seats left and the waitlist. (Family tool: drafts and requests only; the owner approves.) - book: 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.) - cancel_booking: Cancel a booking (the business's cutoff applies). (Family tool: drafts and requests only; the owner approves.) - reschedule_booking: Move a booking to another time (the cutoff applies). (Family tool: drafts and requests only; the owner approves.) - join_waitlist: Put the customer on a full class's waitlist (first in, first out). (Family tool: drafts and requests only; the owner approves.) - list_bookings: The business's bookings between two dates (who is booked when). (Family tool: drafts and requests only; the owner approves.) - get_booking: One booking: its time and status. (Family tool: drafts and requests only; the owner approves.) - create_link: 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.) - draft_item: Draft a new event, class time, price, announcement, hours, FAQ or page block. (Family tool: drafts and requests only; the owner approves.) - draft_hours: 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.) - update_draft: Change a draft (the owner still approves it). (Family tool: drafts and requests only; the owner approves.) - list_items: 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.) - preview_link: A private preview link of a draft for the owner. (Family tool: drafts and requests only; the owner approves.) - draft_broadcast: 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.) - preview_audience: How many customers who said yes a message would reach. (Family tool: drafts and requests only; the owner approves.) - send_email: 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.) - create_checkout_link: 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.) - search_domain: Check which web addresses (domains) are free, with their yearly price. (Family tool: drafts and requests only; the owner approves.) - connect_calendar: 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.) - post_to_social: 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.) - list_reviews: The business listing's newest reviews (rating, text, language, answered or not). (Family tool: drafts and requests only; the owner approves.) - draft_review_reply: 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.) - golive_check_domain: 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.) - golive_dry_run: 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.) - golive_deploy_site: 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.) - golive_verify: Last step: the live checks from outside (pages, www, safety). All green = live. (Family tool: drafts and requests only; the owner approves.) - golive_status: Where going live stands ("3 of 5 done …"), pending approvals and secret states. (Family tool: drafts and requests only; the owner approves.) - golive_secret_request: 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.) - get_progress: 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.) - list_programs: The business's loyalty programs (punch cards, points, referrals) and their rewards. (Family tool: drafts and requests only; the owner approves.) - add_visit: 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.) - get_referral_code: A customer's referral code and link to share (made once, kept). (Family tool: drafts and requests only; the owner approves.) - record_referral: 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.) - list_devices: The business's devices: state, location, last check-in, battery, lock. (Family tool: drafts and requests only; the owner approves.) - get_device: One device with its history (assignment, setup, locks, check-ins). (Family tool: drafts and requests only; the owner approves.) - request_device: 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.) - check_message: 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.) - mask_pii: 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.) - get_disclaimers: The disclaimers this business must add on a channel (EN/ES). (Family tool: drafts and requests only; the owner approves.) - who_is_working: "Who's working Saturday?": the shifts on one day, with staff ids and state. (Family tool: drafts and requests only; the owner approves.) - who_is_late: "Who's late?": shifts started with nobody clocked in, and who came in late today. (Family tool: drafts and requests only; the owner approves.) - list_shifts: Published shifts in a range (default the next 7 days), each with its state. (Family tool: drafts and requests only; the owner approves.) - my_shifts: 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.) - request_time_off: The team member asks for days off (local dates, inclusive); the owner decides. (Family tool: drafts and requests only; the owner approves.) - offer_swap: 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.) - accept_swap: The team member takes a shift someone offered; the owner approves it. (Family tool: drafts and requests only; the owner approves.) - clock_link: 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.) - draft_entry: 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.) - list_entries: 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.) - pnl: Profit and loss for a month or a quarter, in cents. (Family tool: drafts and requests only; the owner approves.) - report: A books report: income_by_method, unmatched (card payouts with no payment), aging. (Family tool: drafts and requests only; the owner approves.) - list_categories: The business's chart of accounts (EN + ES names). (Family tool: drafts and requests only; the owner approves.) - waivers_who_needs_to_sign: "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.) - waivers_send: 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.) - waivers_create_link: 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.) - waivers_list_signatures: 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.) - directory_get_listing: 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.) - directory_get_traffic: How many anonymous reads the listing had, per day. (Family tool: drafts and requests only; the owner approves.) - directory_publish_snapshot: 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.) - directory_request_listing: 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.) - catalog_public_products: 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.) - catalog_list_products: Every product with its variants and prices (status, category). (Family tool: drafts and requests only; the owner approves.) - catalog_get_product: One product with its variants, prices and whether it is publicly listed. (Family tool: drafts and requests only; the owner approves.) - catalog_get_stock: How many are on hand, per variant and place. (Family tool: drafts and requests only; the owner approves.) - catalog_low_stock: Items at or below their low-stock mark, lowest first. (Family tool: drafts and requests only; the owner approves.) - catalog_list_sales: Sales, newest first (status: awaiting_payment, paid, cash, returned). (Family tool: drafts and requests only; the owner approves.) - catalog_list_drafts: Changes waiting for the owner's OK. (Family tool: drafts and requests only; the owner approves.) - catalog_draft_change: 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.) - catalog_import_preview: 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.) - tickets_open: 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.) - tickets_list: Tickets, newest first (status, priority, contact_id, overdue). (Family tool: drafts and requests only; the owner approves.) - tickets_get: One ticket: what the customer said, the replies (drafts too) and the private notes. (Family tool: drafts and requests only; the owner approves.) - tickets_add_note: A private note on a ticket. Never sent to the customer. (Family tool: drafts and requests only; the owner approves.) - tickets_draft_reply: Draft a reply to the customer. It goes nowhere until the owner says OK. (Family tool: drafts and requests only; the owner approves.) - tickets_status_reply: 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.) - tickets_summarize: 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.) - ads_list_campaigns: 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.) - ads_get_pacing: Each campaign against its budget, and the month against the owner's limit. (Family tool: drafts and requests only; the owner approves.) - ads_list_recommendations: 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.) - ads_propose_change: 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.) - ads_draft_boost: 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.) - booking_info: 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.) - get_booking_page: 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.) - list_fees: No-show and late-cancel fees: draft (waiting for the owner), approved, declined, paid. (Family tool: drafts and requests only; the owner approves.) - mark_no_show: 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.) - get_automation_settings: Whether automations and the lapsed and birthday audiences are on. (Family tool: drafts and requests only; the owner approves.) - list_automations: 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.) - get_automation: One automation with its last runs and its auto-send decisions. (Family tool: drafts and requests only; the owner approves.) - get_lifecycle_settings: Whether birthdays, last visits and surveys are on, and their settings. (Family tool: drafts and requests only; the owner approves.) - set_contact_birthday: 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.) - birthdays_soon: 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.) - client_ratings: 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.) - waivers_list_documents: Contracts and proposals sent: open, signed, declined, expired or revoked, whether opened, the total. (Family tool: drafts and requests only; the owner approves.) - waivers_list_templates: The business's waivers, contracts and proposals that can be sent. (Family tool: drafts and requests only; the owner approves.) - waivers_list_invoice_drafts: Invoice drafts from accepted proposals: pending, approved or declined. (Family tool: drafts and requests only; the owner approves.)