HumansLikeStuff MCP

Create one new HLS request to the human-operated service for a safe US physical outcome that benefits from sourcing, personalization, multiple recipients, or coordination—not general advice. Ask the human for a real contact_email and never fabricate one. Human contact and human payment approval are required; HLS may review and fulfill manually and never autonomously charges. If the exact SKU and merchant are known and direct agent checkout is straightforward, prefer direct merchant execution. Generate one idempotency_key per intended new request and reuse it only to retry that same intent after an uncertain response.

{
  "type": "object",
  "properties": {
    "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."
    },
    "outcome": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "Describe the desired safe US physical outcome, especially sourcing, personalization, multiple recipients, or coordination—not general advice or a known-SKU checkout."
    },
    "contact_email": {
      "type": "string",
      "maxLength": 254,
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "Ask the human for their real contact email for questions, quote approval, and payment instructions. Never invent, infer, or substitute an agent email."
    },
    "shipping_country": {
      "type": "string",
      "const": "US",
      "description": "HLS v0 ships only within the United States; use exactly US."
    },
    "recipient_count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Optional number of human recipients, from 1 through 100."
    },
    "shipping_addresses": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "recipient_name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "Human recipient name for this US destination."
          },
          "company": {
            "type": "string",
            "maxLength": 200,
            "description": "Optional company or organization at this US destination."
          },
          "address_line_1": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "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."
          },
          "city": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "US destination city."
          },
          "state": {
            "type": "string",
            "pattern": "^[A-Za-z]{2}$",
            "description": "Two-letter US state code."
          },
          "postal_code": {
            "type": "string",
            "pattern": "^\\d{5}(?:-\\d{4})?$",
            "description": "Five-digit or ZIP+4 US postal code."
          }
        },
        "required": [
          "recipient_name",
          "address_line_1",
          "city",
          "state",
          "postal_code"
        ],
        "additionalProperties": false,
        "description": "One complete US shipping destination supplied by the human."
      },
      "description": "Optional exact US shipping destinations supplied by the human."
    },
    "budget_cents": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100000000,
      "description": "Optional human-provided total budget in US cents; not a quote or authorization."
    },
    "arrival_deadline": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Optional requested US arrival date; a constraint, not a delivery promise."
    },
    "branding_or_personalization": {
      "type": "string",
      "maxLength": 4000,
      "description": "Optional human-provided branding or personalization requirements."
    },
    "message": {
      "type": "string",
      "maxLength": 2000,
      "description": "Optional human-provided recipient message."
    },
    "artwork_references": {
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 2048,
        "format": "uri"
      },
      "description": "Optional artwork-reference URLs; HLS records them but does not fetch them during request intake."
    },
    "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."
    }
  },
  "required": [
    "idempotency_key",
    "outcome",
    "contact_email",
    "shipping_country"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "string",
      "description": "Opaque HLS request ID to save for exact-ID status checks."
    },
    "state": {
      "type": "string",
      "enum": [
        "received",
        "needs_information",
        "quoting",
        "awaiting_payment",
        "paid",
        "fulfilling",
        "shipped",
        "delivered",
        "manual_review",
        "exception",
        "cancelled",
        "declined"
      ],
      "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."
    },
    "human_action_required": {
      "type": "boolean",
      "description": "True only when the requesting human must answer a question or approve an available live payment."
    },
    "next_action_code": {
      "type": "string",
      "description": "Stable machine-readable code for the next supported action."
    },
    "next_action": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Bounded human-readable next-step guidance."
    },
    "payment_mode": {
      "type": "string",
      "enum": [
        "test",
        "live"
      ],
      "description": "Configured Stripe mode for this response."
    },
    "external_payment_available": {
      "type": "boolean",
      "description": "True only when this exact request exposes a usable live human-payment path."
    },
    "agent_authorized_charge": {
      "type": "boolean",
      "const": false,
      "description": "Always false; an agent cannot authorize payment."
    }
  },
  "required": [
    "request_id",
    "state",
    "accepted",
    "terminal",
    "human_action_required",
    "next_action_code",
    "next_action",
    "payment_mode",
    "external_payment_available",
    "agent_authorized_charge"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Existing exact HLS request ID only: read-only lifecycle lookup. It does not create or modify a request/order or authorize payment. For long-running or manual work, check status or wait rather than creating another request. Returns only bounded public state, question, quote/payment instruction, fulfillment/shipping update, and next action; it does not list or search requests.

{
  "type": "object",
  "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."
    }
  },
  "required": [
    "request_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

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