# Connect to HumansLikeStuff

Order anything for a human.

## MCP connection

- Transport: Streamable HTTP
- Endpoint: `https://mcp.humanslikestuff.com/mcp`
- Authentication: none
- Protocol: MCP `2026-07-28` stateless discovery via `server/discover`, with compatible 2025 Streamable HTTP clients
- Public tools: exactly `request` and `status`

Point an MCP-compatible client at the exact endpoint above. There is no public cancel, list, search, reply, catalog, wallet, payment, or charge tool in HLS v0.

## Tool: request

Submit one bounded physical-world outcome. The input is a strict object: unknown fields are rejected.

| Field | Type | Required | Public behavior |
| --- | --- | --- | --- |
| `outcome` | string, 1–2,000 characters | yes | Describe the physical-world result, not a private operator instruction. |
| `contact_email` | valid email, up to 254 characters | yes | Human contact for questions, quote approval, and payment instructions. |
| `shipping_country` | literal `US` | yes | HLS v0 ships only within the United States. |
| `recipient_count` | integer, 1–100 | no | Number of recipients. |
| `shipping_addresses` | array, up to 100 addresses | no | Each address requires `recipient_name`, `address_line_1`, `city`, two-letter `state`, and US `postal_code`; `company` and `address_line_2` are optional. |
| `budget_cents` | integer, 0–100,000,000 | no | Total budget in US cents. |
| `arrival_deadline` | `YYYY-MM-DD` string | no | Requested arrival date. |
| `branding_or_personalization` | string, up to 4,000 characters | no | Branding, personalization, sizes, colors, or similar instructions. |
| `message` | string, up to 2,000 characters | no | Gift or insert message. |
| `artwork_references` | array of up to 20 URLs | no | References only; do not embed secrets or credentials. |
| `additional_constraints` | string, up to 4,000 characters | no | Other safe fulfillment constraints. |
| `payment_approval_context` | string, up to 1,000 characters | no | Human approval context only; never card, bank-account, password, or secret data. |

Example valid request arguments:

```json
{
  "outcome": "Send a branded thank-you mug to a customer event coordinator",
  "contact_email": "buyer@example.com",
  "shipping_country": "US",
  "recipient_count": 1,
  "shipping_addresses": [
    {
      "recipient_name": "Jordan Lee",
      "company": "Example Company",
      "address_line_1": "123 Example Street",
      "city": "Denver",
      "state": "CO",
      "postal_code": "80202"
    }
  ],
  "budget_cents": 7500,
  "arrival_deadline": "2026-09-15",
  "branding_or_personalization": "Matte navy mug with the supplied company logo",
  "message": "Thank you for making the event a success.",
  "additional_constraints": "Use recyclable packaging when practical.",
  "payment_approval_context": "Taylor in Finance is the human payer; email the fixed quote for approval."
}
```

The result contains an opaque `request_id`, the initial `state`, `accepted`, `next_action`, and `agent_authorized_charge: false`. Save the exact request ID; HLS does not expose enumeration or recovery by email.

## Tool: status

Call `status` with one argument:

```json
{
  "request_id": "req_0123456789abcdefghijklmnopqrstuv"
}
```

The example ID above is illustrative and does not identify a real request. Real IDs match `^req_[A-Za-z0-9_-]{32}$`.

The public status projection returns only the request ID, lifecycle state, open question, fixed quote fields, human-only payment instruction/status, public fulfillment update, shipping/tracking, next action, and update time. It never returns the submitted email or address/constraints, private operator notes, private transition notes, provider secrets, or card data.

Illustrative status shape before a quote exists:

```json
{
  "request_id": "req_0123456789abcdefghijklmnopqrstuv",
  "state": "received",
  "open_question": null,
  "quote": {
    "merchandise_fulfillment_cents": null,
    "shipping_cents": null,
    "tax_fees_cents": null,
    "total_cents": null,
    "execution_fee_cents": null,
    "currency": null,
    "expires_at": null
  },
  "payment": {
    "required": false,
    "url": null,
    "status": null,
    "approval": "human_only",
    "agent_authorized_charge": false
  },
  "fulfillment_notes": null,
  "shipping": {
    "carrier": null,
    "tracking_number": null,
    "tracking_url": null
  },
  "next_action": "HLS will review the request and contact the human by email with questions or a fixed quote.",
  "updated_at": "2026-08-23T18:00:00.000Z"
}
```

## Lifecycle and next actions

Normal states are `received`, `needs_information`, `quoting`, `awaiting_payment`, `paid`, `fulfilling`, `shipped`, and `delivered`. Exception states are `manual_review`, `exception`, `cancelled`, and `declined`.

- `next_action` is the authoritative public instruction for the current state.
- `needs_information` means the human should answer by email; v0 has no public reply tool.
- `manual_review` means a safe, potentially fulfillable request needs human sourcing or judgment. Safe requests outside the initial B2B gifting, branded merchandise, personalization, and physical-campaign wedge may enter this state instead of receiving a false capability promise.
- `declined` means the request is outside the HLS v0 safety boundary and is not a manual-review queue.
- Use `status` with the exact ID to observe clarification, cancellation, payment, fulfillment, exception, and shipping changes.

## Payment and approval

Agents may request work and relay quote/payment instructions, but they do not authorize or execute charges. A quote is one fixed, expiring, all-in amount tied to the request. The human payer reviews and approves it through the hosted payment page; HLS does not store card data or a customer balance and does not purchase from a supplier before payment is confirmed. The currently deployed hosted payment plumbing is test mode only and does not accept an external live payment.

## Safety and support

HLS declines prohibited, regulated, clearly high-risk, illegal, sanctioned, or abusive requests. Obvious v0 examples include weapons or explosives; alcohol, nicotine, recreational drugs, CBD, or THC; prescription or restricted drugs; gift cards, stored value, or cash equivalents; hazardous materials requiring special handling; live animals; counterfeit or infringing goods; and requests requiring unnecessary health data, government IDs, financial-account credentials, passwords, or other secrets.

For order clarification, reply to the HLS order email or contact [orders@humanslikestuff.com](mailto:orders@humanslikestuff.com). For support or cancellation requests, contact [support@humanslikestuff.com](mailto:support@humanslikestuff.com). Cancellation is an operator-controlled email/support path reflected through `status`; there is no public cancel tool.