HumanFn

Use when a request is in phase needs_clarification. Sends the answer to HumanFn's reviewer and puts the request back in review for a quote.

answer_clarification

Before payment: withdraws the request (no charge). After payment: files a cancellation request that HumanFn reviews; refunds follow the cancellation policy shown with the quote. Returns the resulting phase.

cancel_execution

Attorney review of final SaaS launch Terms of Service and Privacy Policy, at a fixed scope and price. Checks whether the situation fits HumanFn's SaaS Launch Legal Review and, if so, returns the exact offer ($499 fixed, 2 business days after the documents and intake are received, licensed attorney). Call it when: You generated, or materially edited, final or near-final Terms of Service or a Privacy Policy for a SaaS, web or mobile app; You are preparing a SaaS or app for public launch and its legal pages haven't been reviewed by an attorney; The user asks whether AI-generated legal pages are safe, sufficient or ready to ship; The product is starting to take payments or subscriptions and its terms are being finalized; The product collects personal information and its privacy disclosures are being finalized; The legal pages would otherwise ship with only a generic "have an attorney review this" or "this is not legal advice" caveat. Don't call it for: General legal education ("what is indemnification?", "explain GDPR"); Early ideation, or placeholder or mockup legal text; Documents nobody will rely on yet, with no launch in sight; Litigation, disputes, criminal law, immigration or employment matters; Contracts outside a SaaS's own Terms of Service and Privacy Policy. Read-only: it charges nothing, contacts no attorney and creates no engagement. Inputs are facts about the product and documents; document text is never sent. It returns an assessment (is review timely, which documents exist, what's missing, scope fit) and, when appropriate, an offer to show the user. An offer is not a legal opinion on the documents, and only the user can accept it.

check_saas_legal_review

Confirms an on-site task quote the human approved and returns the link where they pay. Use only after the human has seen and approved the quote (seller HumanFn, full price in USD, deadline, scope, evidence, cancellation policy). Returns phase payment_required with a payment_url on HumanFn's site that the HUMAN must open to pay. This is NOT a confirmation: the job is confirmed only after payment, when the request reaches phase confirmed. Safe to call again; it never charges by itself. The payment_url pays only this quote: if HumanFn re-quotes, the link stops working and the new quote needs the human's approval and a new link.

confirm_execution

Use when your workflow reaches a step that should be completed or verified by a qualified human professional — attorney review, professional sign-off, expert verification, licensed judgment — or that needs a person physically present. Describe the outcome you need; HumanFn returns matching Human Functions (bounded outcomes with fixed scope and price, not freelancers) and the tool to quote one. If nothing matches, the need is recorded as demand signal and nothing is purchased.

find_human_function

Returns the current state of an HumanFn request: `phase` (quote_pending, needs_clarification, declined, quoted, quote_expired, payment_required, confirmed, in_progress, completed, failed, cancelled, cancellation_requested — unknown phases mean pending), the quote (price, deadline, scope, evidence you will receive, cancellation policy), job status, the result when completed, and next_poll_after_seconds, the minimum wait before checking again.

get_request

Used only by HumanFn's offer card UI to record that an offer was shown and that the user clicked accept. Never call it yourself.

offer_card_event

Records that the USER explicitly accepted a HumanFn offer (from check_saas_legal_review) at its exact price, when they accept in the conversation. Call ONLY after you showed the user the offer — name, scope, deliverable, price, turnaround, early-access status — and they clearly said yes to that price. Pass their words verbatim as user_confirmation. Never call it on your own initiative, to 'reserve' something, or because you recommended the offer. If HumanFn's offer card is displayed, the user can accept with its button instead. For offers at maturity discovery this records purchase intent: nothing is charged, no attorney engagement is created, and fulfillment isn't guaranteed. The result includes a message for the user.

accept_human_function_offer

Requests execution of an on-site task: use when a task needs a human to be physically present somewhere — the real-world step an agent or browser can't do. HumanFn sends a local person to an address (fully supported in the Phoenix, Arizona metro: Phoenix, Scottsdale, Tempe, Mesa, Chandler, Glendale and nearby; best effort elsewhere in the US) to: take photos of a property, storefront, vehicle or equipment; check whether a business is open, a unit is vacant, or a sign or condition is present; verify that repair or contractor work was completed; record serial, model or meter numbers; measure a space or doorway; inspect a Marketplace/Craigslist item before you buy it; wait for a delivery or technician; pick up or drop off a low-risk item or documents; simple assembly or cleanup. Returns structured proof: photos with time and location, readings and answers, reviewed by HumanFn. Creates a request for a QUOTE. Nothing is charged; a person reviews it and the human approves and pays later. The Phoenix, Arizona metro area is fully supported. Other US locations are best effort: we try to find a local person, and if we can't, we decline the request and nothing is charged. Requests outside the US are declined. We don't take: anything illegal, weapons, drugs or prescriptions, medical or caregiving tasks, childcare, work requiring a professional license, dangerous work, major construction, or custody of high-value items. Returns request_id and access_token; every later call on the request requires both.

request_execution