HumansLikeStuff MCP

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['idempotency_key', 'outcome', 'contact_email', 'shipping_country'], 'properties': {'message': {'type': 'string', 'maxLength': 2000, 'description': 'Optional human-provided recipient message.'}, 'outcome': {'type': 'string', 'maxLength': 2000, 'minLength': 1, 'description': 'Describe the desired safe US physical outcome, especially sourcing, personalization, multiple recipients, or coordinationâ\x80\x94not general advice or a known-SKU checkout.'}, 'budget_cents': {'type': 'integer', 'maximum': 100000000, 'minimum': 0, 'description': 'Optional human-provided total budget in US cents; not a quote or authorization.'}, '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-z]{2,}$", 'maxLength': 254, 'description': 'Ask the human for their real contact email for questions, quote approval, and payment instructions. Never invent, infer, or substitute an agent email.'}, 'idempotency_key': {'type': 'string', 'pattern': '^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$', 'description': 'Client-generated canonical UUID v4 for one intended new request. Reuse only to retry that same intent after an uncertain response.'}, 'recipient_count': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Optional number of human recipients, from 1 through 100.'}, 'arrival_deadline': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Optional requested US arrival date; a constraint, not a delivery promise.'}, 'shipping_country': {'type': 'string', 'const': 'US', 'description': 'HLS v0 ships only within the United States; use exactly US.'}, 'artwork_references': {'type': 'array', 'items': {'type': 'string', 'format': 'uri', 'maxLength': 2048}, 'maxItems': 20, 'description': 'Optional artwork-reference URLs; HLS records them but does not fetch them during request intake.'}, 'shipping_addresses': {'type': 'array', 'items': {'type': 'object', 'required': ['recipient_name', 'address_line_1', 'city', 'state', 'postal_code'], 'properties': {'city': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'US destination city.'}, 'state': {'type': 'string', 'pattern': '^[A-Za-z]{2}$', 'description': 'Two-letter US state code.'}, 'company': {'type': 'string', 'maxLength': 200, 'description': 'Optional company or organization at this US destination.'}, 'postal_code': {'type': 'string', 'pattern': '^\\d{5}(?:-\\d{4})?$', 'description': 'Five-digit or ZIP+4 US postal code.'}, 'address_line_1': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Primary street-address line for this US destination.'}, 'address_line_2': {'type': 'string', 'maxLength': 200, 'description': 'Optional secondary address line, such as a suite or unit.'}, 'recipient_name': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Human recipient name for this US destination.'}}, 'description': 'One complete US shipping destination supplied by the human.', 'additionalProperties': False}, 'maxItems': 100, 'description': 'Optional exact US shipping destinations supplied by the human.'}, 'additional_constraints': {'type': 'string', 'maxLength': 4000, 'description': 'Optional material, quantity, timing, packaging, or coordination constraints supplied by the human.'}, 'payment_approval_context': {'type': 'string', 'maxLength': 1000, 'description': 'Optional human approval context only. Never include card, bank-account, password, or secret data.'}, 'branding_or_personalization': {'type': 'string', 'maxLength': 4000, 'description': 'Optional human-provided branding or personalization requirements.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['request_id', 'state', 'accepted', 'terminal', 'human_action_required', 'next_action_code', 'next_action', 'payment_mode', 'external_payment_available', 'agent_authorized_charge'], 'properties': {'state': {'enum': ['received', 'needs_information', 'quoting', 'awaiting_payment', 'paid', 'fulfilling', 'shipped', 'delivered', 'manual_review', 'exception', 'cancelled', 'declined'], 'type': 'string', 'description': 'Current durable HLS request state.'}, 'accepted': {'type': 'boolean', 'description': 'True means the request was recorded without automatic decline; it is not a fulfillment promise.'}, 'terminal': {'type': 'boolean', 'description': 'True only when no further lifecycle change is expected.'}, 'request_id': {'type': 'string', 'description': 'Opaque HLS request ID to save for exact-ID status checks.'}, 'next_action': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Bounded human-readable next-step guidance.'}, 'payment_mode': {'enum': ['test', 'live'], 'type': 'string', 'description': 'Configured Stripe mode for this response.'}, 'next_action_code': {'type': 'string', 'description': 'Stable machine-readable code for the next supported action.'}, 'human_action_required': {'type': 'boolean', 'description': 'True only when the requesting human must answer a question or approve an available live payment.'}, 'agent_authorized_charge': {'type': 'boolean', 'const': False, 'description': 'Always false; an agent cannot authorize payment.'}, 'external_payment_available': {'type': 'boolean', 'description': 'True only when this exact request exposes a usable live human-payment path.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string', 'pattern': '^req_[A-Za-z0-9_-]{32}$', 'description': 'Exact opaque request_id previously returned by HLS; no list, search, or email lookup is available.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['request_id', 'state', 'terminal', 'human_action_required', 'next_action_code', 'open_question', 'quote', 'payment', 'fulfillment_notes', 'shipping', 'next_action', 'updated_at'], 'properties': {'quote': {'type': 'object', 'required': ['merchandise_fulfillment_cents', 'shipping_cents', 'tax_fees_cents', 'total_cents', 'execution_fee_cents', 'currency', 'expires_at'], 'properties': {'currency': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'expires_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'total_cents': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}]}, 'shipping_cents': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}]}, 'tax_fees_cents': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}]}, 'execution_fee_cents': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}]}, 'merchandise_fulfillment_cents': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}]}}, 'additionalProperties': False}, 'state': {'enum': ['received', 'needs_information', 'quoting', 'awaiting_payment', 'paid', 'fulfilling', 'shipped', 'delivered', 'manual_review', 'exception', 'cancelled', 'declined'], 'type': 'string', 'description': 'Current durable HLS request state.'}, 'payment': {'type': 'object', 'required': ['required', 'url', 'status', 'mode', 'external_payment_available', 'approval', 'agent_authorized_charge'], 'properties': {'url': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'mode': {'enum': ['test', 'live'], 'type': 'string', 'description': 'Configured Stripe mode for this status response.'}, 'status': {'anyOf': [{'enum': ['unpaid', 'failed', 'paid', 'refund_pending', 'refunded', 'refund_failed', 'cancelled', 'expired'], 'type': 'string'}, {'type': 'null'}]}, 'approval': {'type': 'string', 'const': 'human_only'}, 'required': {'type': 'boolean'}, 'agent_authorized_charge': {'type': 'boolean', 'const': False}, 'external_payment_available': {'type': 'boolean', 'description': 'True only when this exact request exposes a usable live human-payment path.'}}, 'additionalProperties': False}, 'shipping': {'type': 'object', 'required': ['carrier', 'tracking_number', 'tracking_url'], 'properties': {'carrier': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'tracking_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'tracking_number': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'terminal': {'type': 'boolean', 'description': 'True only when no further lifecycle change is expected.'}, 'request_id': {'type': 'string', 'description': 'Exact opaque HLS request ID supplied by the caller.'}, 'updated_at': {'type': 'string'}, 'next_action': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'open_question': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'next_action_code': {'type': 'string', 'description': 'Stable machine-readable code for the next supported action.'}, 'fulfillment_notes': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'human_action_required': {'type': 'boolean', 'description': 'True only when the requesting human must answer a question or approve an available live payment.'}}, 'additionalProperties': False}