HumanFn

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.

{
  "type": "object",
  "properties": {
    "context_summary": {
      "type": "string",
      "minLength": 20,
      "maxLength": 1500,
      "description": "What the product is (business model, customers), where you are in the workflow, and what changed in the legal documents. From what you already know; no document text or secrets."
    },
    "documents": {
      "maxItems": 7,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "terms_of_service",
          "privacy_policy",
          "cookie_policy",
          "dpa",
          "acceptable_use_policy",
          "eula",
          "other"
        ]
      },
      "description": "Legal documents that exist now."
    },
    "documents_state": {
      "type": "string",
      "enum": [
        "placeholder",
        "early_draft",
        "final_or_near_final"
      ],
      "description": "How ready the documents are."
    },
    "launch_status": {
      "type": "string",
      "enum": [
        "exploring",
        "building",
        "preparing_launch",
        "live"
      ],
      "description": "Where the product is: exploring an idea, building, preparing a public launch, or already live."
    },
    "trigger": {
      "description": "What made you check now.",
      "type": "string",
      "enum": [
        "generated_or_edited_legal_docs",
        "preparing_public_launch",
        "user_asked_if_ready",
        "payments_or_subscriptions",
        "collecting_personal_data",
        "would_recommend_counsel",
        "other"
      ]
    },
    "jurisdictions": {
      "description": "Where users are, e.g. ['US'] or ['US', 'EU'].",
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 60
      }
    },
    "customers": {
      "description": "Who the product sells to: businesses, consumers, or both.",
      "type": "string",
      "enum": [
        "b2b",
        "b2c",
        "both"
      ]
    },
    "takes_payments": {
      "description": "Charges users (one-off or subscription).",
      "type": "boolean"
    },
    "data_collected": {
      "description": "Personal-data categories, e.g. ['email', 'payment info', 'usage analytics'].",
      "maxItems": 15,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 80
      }
    },
    "third_party_processors": {
      "description": "e.g. ['Stripe', 'Supabase', 'PostHog'].",
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 80
      }
    },
    "special_categories": {
      "description": "Health/medical data, a financial-services product, or directed at children. ['none'] if none apply.",
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "health_data",
          "financial_services",
          "children",
          "none"
        ]
      }
    },
    "approximate_combined_word_count": {
      "description": "Approximate total words across the Terms of Service and Privacy Policy.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 1000000
    },
    "explicit_questions": {
      "description": "Up to 3 questions the user wants the attorney to answer.",
      "maxItems": 3,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 5,
        "maxLength": 300
      }
    }
  },
  "required": [
    "context_summary",
    "documents",
    "documents_state",
    "launch_status"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

{
  "type": "object",
  "properties": {
    "offer_id": {
      "type": "string",
      "pattern": "^off_[0-9A-Za-z]{22}$",
      "description": "The offer ID returned by check_saas_legal_review (off_…)."
    },
    "accepted_price_usd": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "The exact price the user accepted, as shown in the offer (e.g. 499). Must match the offer."
    },
    "user_confirmation": {
      "type": "string",
      "minLength": 2,
      "maxLength": 500,
      "description": "The user's own words accepting the offer, verbatim (e.g. 'Yes, I accept the review at $499')."
    },
    "contact_email": {
      "description": "Optional. Only with the user's permission: lets HumanFn contact them if it can arrange the service.",
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    }
  },
  "required": [
    "offer_id",
    "accepted_price_usd",
    "user_confirmation"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

{
  "type": "object",
  "properties": {
    "offer_id": {
      "type": "string",
      "pattern": "^off_[0-9A-Za-z]{22}$",
      "description": "The offer ID returned by check_saas_legal_review (off_…)."
    },
    "card_token": {
      "type": "string",
      "pattern": "^oct_[A-Za-z0-9_-]{43}$",
      "description": "Token issued to the offer card with the offer (oct_…)."
    },
    "event": {
      "type": "string",
      "enum": [
        "rendered",
        "accepted"
      ],
      "description": "What happened on the card: shown, or the accept button was clicked."
    },
    "contact_email": {
      "description": "Email the user typed into the card, if any.",
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    }
  },
  "required": [
    "offer_id",
    "card_token",
    "event"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

{
  "type": "object",
  "properties": {
    "objective": {
      "type": "string",
      "minLength": 10,
      "maxLength": 2000,
      "description": "The outcome you need from a qualified human, in plain words, e.g. 'Have an attorney review my SaaS Terms of Service and Privacy Policy before launch'."
    },
    "professional_credential": {
      "description": "Qualification the work needs, if any, e.g. 'licensed attorney', 'CPA', 'structural engineer'.",
      "type": "string",
      "maxLength": 200
    },
    "jurisdiction": {
      "description": "Where it applies, e.g. 'United States', 'California', 'EU'.",
      "type": "string",
      "maxLength": 200
    },
    "deadline": {
      "description": "When the user needs it, e.g. 'before launch next Friday' or an ISO 8601 date.",
      "type": "string",
      "maxLength": 100
    },
    "approximate_budget_usd": {
      "description": "Roughly what the user expects to spend, in US dollars, if known.",
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 1000000
    },
    "workflow_context": {
      "description": "One or two sentences on where you are in the workflow and why a human is needed (e.g. 'preparing a Next.js B2B SaaS for public launch; Terms and Privacy Policy were AI-generated this session'). No confidential details, no document text.",
      "type": "string",
      "maxLength": 500
    }
  },
  "required": [
    "objective"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

{
  "type": "object",
  "properties": {
    "objective": {
      "type": "string",
      "minLength": 10,
      "maxLength": 4000,
      "description": "What must be true or be captured when the job is done. Be specific: what to photograph, measure, check, deliver."
    },
    "address": {
      "type": "string",
      "minLength": 5,
      "maxLength": 500,
      "description": "Full street address. The Phoenix, AZ metro is fully supported; other US locations are best effort; locations outside the US are declined."
    },
    "access_notes": {
      "description": "Gate codes, who to ask for, where to park, hours.",
      "type": "string",
      "maxLength": 1000
    },
    "complete_by": {
      "description": "Deadline for the outcome. ISO 8601 with offset (Phoenix is UTC-07:00).",
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
    },
    "max_budget_usd": {
      "description": "The most the customer is willing to pay, in US dollars. Quotes above it are flagged.",
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "contact_email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "The human customer's email. Quotes and status links are sent here."
    },
    "contact_name": {
      "description": "The customer's name, for the quote.",
      "type": "string",
      "maxLength": 200
    },
    "contact_phone": {
      "description": "The customer's phone number, for urgent questions about the task.",
      "type": "string",
      "maxLength": 40
    },
    "client_request_id": {
      "description": "Your idempotency key. Retrying with the same key returns the same request instead of creating a duplicate.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    }
  },
  "required": [
    "objective",
    "address",
    "contact_email"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "string",
      "pattern": "^req_[0-9A-Za-z]{22}$",
      "description": "The request ID returned by request_execution (req_…)."
    },
    "access_token": {
      "type": "string",
      "pattern": "^rqt_[A-Za-z0-9_-]{43}$",
      "description": "The access token returned with the request (rqt_…); it authorizes access to this request."
    }
  },
  "required": [
    "request_id",
    "access_token"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "string",
      "pattern": "^req_[0-9A-Za-z]{22}$",
      "description": "The request ID returned by request_execution (req_…)."
    },
    "access_token": {
      "type": "string",
      "pattern": "^rqt_[A-Za-z0-9_-]{43}$",
      "description": "The access token returned with the request (rqt_…); it authorizes access to this request."
    },
    "answer": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4000,
      "description": "The answer to the reviewer's question, from the customer."
    }
  },
  "required": [
    "request_id",
    "access_token",
    "answer"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "string",
      "pattern": "^req_[0-9A-Za-z]{22}$",
      "description": "The request ID returned by request_execution (req_…)."
    },
    "access_token": {
      "type": "string",
      "pattern": "^rqt_[A-Za-z0-9_-]{43}$",
      "description": "The access token returned with the request (rqt_…); it authorizes access to this request."
    },
    "quote_id": {
      "type": "string",
      "pattern": "^quo_[0-9A-Za-z]{22}$",
      "description": "The ID of the quote the human approved (quo_…), as shown in the request's quote."
    }
  },
  "required": [
    "request_id",
    "access_token",
    "quote_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "string",
      "pattern": "^req_[0-9A-Za-z]{22}$",
      "description": "The request ID returned by request_execution (req_…)."
    },
    "access_token": {
      "type": "string",
      "pattern": "^rqt_[A-Za-z0-9_-]{43}$",
      "description": "The access token returned with the request (rqt_…); it authorizes access to this request."
    }
  },
  "required": [
    "request_id",
    "access_token"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}