# HOMEMADE: guide for AI agents

HOMEMADE (הומייד) is a weekly subscription of home-cooked lunches in Israel.
The food is cooked by hand, chilled, and left at the door at night in an
insulated cooler bag with ice packs. It is reheated at home; it is not delivered
hot. No commitment: skip, pause or cancel any week before the Wednesday 21:00
(Israel time) cutoff.

Everything below is live data from the same sources the website uses. No API
key, no auth, JSON, CORS open. Everything is read-only except preparing an
order for the person to review (see Ordering).

## Read the facts

| What | Endpoint |
| --- | --- |
| Menu: dishes, ingredients, listed allergens, images | `GET https://homemade-global.com/api/agent/menu` |
| Price list for new subscriptions, per plan size | `GET https://homemade-global.com/api/agent/pricing` |
| Do we deliver to a city or locality | `GET https://homemade-global.com/api/agent/coverage?city=רמת גן` |
| Order cutoff and first delivery date (Sunday or Tuesday) | `GET https://homemade-global.com/api/agent/delivery` |
| Exact first-week and weekly price + prefilled order link | `GET https://homemade-global.com/api/agent/quote?plan=5&city=חולון&dishes=1,4,7` |

- OpenAPI 3.1: https://homemade-global.com/openapi.json
- API catalog (RFC 9727): https://homemade-global.com/.well-known/api-catalog

## MCP

Streamable HTTP, no key: `https://homemade-global.com/api/mcp/public`. Protocol versions: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26.
The same server runs at `/api/mcp/chatgpt` (the ChatGPT app) and `/api/mcp/claude` (the Claude connector).

| Tool | Returns |
| --- | --- |
| `get_menu` | Current HOMEMADE menu: dish ids, names, descriptions, ingredients, listed allergens, images. |
| `get_dish` | One dish by id: description, ingredients, listed allergens, side variations, image and page URL. |
| `get_pricing` | Weekly prices in ILS for new subscriptions per number of meals, delivery fee and settlement-gate fee. |
| `check_coverage` | Whether a named city or locality is in the delivery area, and whether a settlement-gate fee may apply. |
| `get_delivery_dates` | The weekly order cutoff (Wednesday 21:00, Israel time) and the first delivery dates for an order placed now. |
| `get_policies` | Published answers on skipping a week, pausing, cancelling, the weekly cutoff, refunds, payment, storage, and the allergy notice from the terms of use. |
| `get_quote` | First-week and weekly total for a number of meals and a city, from the live price list. |
| `get_order_link` | A checkout URL on homemade-global.com with the number of meals, city and dishes preselected. Payment is made by the person on PayMe's hosted page. |
| `create_order_draft` | Saves the order details the person provided for 48 hours and returns a checkout URL where they are prefilled. Creates no account, order, charge or message. The person reviews, accepts the terms and pays on the site. |
| `get_order_draft_status` | Whether a prepared order link is still valid and whether it was opened. Returns no personal details and no payment state. |

Tools that render UI in hosts that support MCP Apps or the ChatGPT Apps SDK:

- `show_menu`: Menu carousel with dish photos and how often each audience group chose each dish in paid orders.
- `show_quote`: Interactive quote card: meals per week, city check, weekly total, first week, delivery dates, cutoff.
- `show_order_link`: Order summary with a button that opens checkout on homemade-global.com.

Every result carries `generated_at`, `valid_until` and `source_url`. A failed
call returns `isError` with `code`, `message` and `retryable`.

- Server card: https://homemade-global.com/api/mcp/public/server-card
- AI catalog: https://homemade-global.com/.well-known/ai-catalog.json
- Registry entry `com.homemade-global/homemade`: `/server.json`, `/.well-known/mcp.json`
- Also: `/.well-known/agent-card.json` (A2A), `/.well-known/ucp`

## Plans and prices

Plan sizes are meals per week: 3, 4, 5, 6, 7, 8, 10, 12, 15. Quote prices from
`/api/agent/pricing` or `/api/agent/quote`, which read the live price list.
These prices are for new subscriptions; an existing subscriber keeps the price
they joined on.

Coverage: `confidence: "listed"` means the locality is on the published list.
`"unlisted"` means the name is accepted by default and the address is confirmed
at signup.

Settlement gate: in a kibbutz, moshav or gated settlement the courier cannot
get in at night, so the delivery is handed over in person by 23:30 the evening
before, for a per-delivery fee. The quote shows both totals when this may apply.

## Ordering: the agent prepares, the person pays

Agents do not place orders, accept the terms or take payment. There are two
ways to hand the order over.

**1. A link with the choices.** The `order_url` from `/api/agent/quote` (or the
`get_order_link` tool) opens checkout with the plan size, city and dishes
already chosen. The person types their own details.

```
https://homemade-global.com/checkout?plan=5&city=חולון&dishes=1,4,7&src=agent
```

**2. A prepared order.** `create_order_draft` (or `POST https://homemade-global.com/api/agent/draft`)
takes the details the person gave the agent and returns a `checkout_url` where
they are already filled in:

```json
{ "plan_size": 5, "city": "חולון", "full_name": "...", "email": "...", "phone": "05XXXXXXXX",
  "person_confirmed": true, "dish_ids": [1, 4, 7], "delivery_day": "sunday",
  "street": "...", "house_number": "12", "floor": "3", "apartment": "7" }
```

- `person_confirmed: true` is required: the person saw the details and asked for
  the order to be prepared.
- Nothing is created: no account, no order, no charge, no email or SMS. The
  details are kept for 48 hours and removed when the person continues to payment.
- There is no field for notes, a gate code or a door sign. The person types
  those on the site.
- The same input returns the same link. Daily limits apply; past them the
  error points to `get_order_link`.
- A locality HOMEMADE does not reach returns `not_served` and no link.
- `get_order_draft_status` (or `GET https://homemade-global.com/api/agent/draft/{draft_id}`) says whether the
  link is still valid and whether it was opened. It returns no personal details
  and no payment state.

On the site the person reviews the details, accepts the terms and pays by card
on PayMe's hosted page. Card data never passes through the agent. Right after
payment they confirm or swap the dishes. The amount charged is the one the
checkout page shows at that moment.

## Allergies (passed on as is)

The service is unequivocally not suitable for anyone with a food allergy or sensitivity, and the Company accepts no responsibility for an allergic reaction or health harm arising from a food allergy or sensitivity. The Company does not warrant that any dish is free of any allergen, even when that allergen does not appear in the dish's ingredient or allergen list. A customer who, or any member of whose household the food is intended for, has a food allergy or sensitivity must contact the Company individually, via the customer service chat on the Site, and verify the suitability of the service for their condition before ordering and before consuming any dish. An order placed without such verification, and any consumption of a dish by a person with an allergy or sensitivity, is at the customer's sole responsibility.

השירות אינו מתאים, באופן חד-משמעי, למי שסובל מאלרגיה או מרגישות למזון, והחברה אינה נוטלת כל אחריות לתגובה אלרגית או לפגיעה בריאותית הנובעת מאלרגיה או מרגישות למזון. החברה אינה מתחייבת שמנה כלשהי נקייה מאלרגן כלשהו, גם כאשר אותו אלרגן אינו מופיע ברשימת הרכיבים או האלרגנים של המנה. לקוח שהוא, או מי מבני ביתו שהמזון מיועד לו, סובל מאלרגיה או מרגישות למזון, חייב ליצור קשר עם החברה באופן פרטני, בצ׳אט שירות הלקוחות באתר, ולברר את התאמת השירות למצבו לפני ההזמנה ולפני כל צריכה של מנה. הזמנה ללא בירור כזה, וכל צריכה של מנה על ידי מי שסובל מאלרגיה או מרגישות, נעשות על אחריות הלקוח בלבד.

HOMEMADE makes no statement that a dish suits a person with a food allergy, or
that it lacks an ingredient, even when the ingredient is not on its list.
Full terms: https://homemade-global.com/terms (section 4).

## Support

Customer service is the chat on the site: https://homemade-global.com/support. There is no phone
line and no WhatsApp, and nobody calls back.
