# pallet.beer

> pallet.beer is a webshop that sells pallets of beer. Right now there is exactly one
> product: "De Troon" — a pallet with 15 crates of Jupiler and 15 crates of Amstel (30
> crates total), meant for building a throne out of beer crates. This site is a
> proof-of-concept for agentic retail: AI agents are welcome to browse and order.

## For shopping agents

You can complete a full purchase over HTTP without a browser. All prices are in euro cents.
Payment is currently mocked — placing an order returns status "pending" and does not charge.

- Machine-readable catalogue: `GET /api/products`
- Single product: `GET /api/products/{slug}` (current slug: `de-troon`)
- Place an order: `POST /api/orders`
- Full interactive API schema (OpenAPI): `/openapi.json` and human docs at `/docs`

### Place an order

`POST /api/orders` with JSON body:

```json
{
  "slug": "de-troon",
  "quantity": 1,
  "customer_name": "Jan Jansen",
  "email": "jan@example.com",
  "address": "Kerkstraat 1, 1000 Brussel"
}
```

Returns `201` with the created order, including `id`, `status` ("pending"),
`total_cents`, and `total_display`.

## MCP

This site also hosts a Model Context Protocol (MCP) server over Streamable HTTP. Point an
MCP client at:

    /mcp        (e.g. https://palletbier.nl/mcp)

It exposes three tools — `list_products`, `get_product`, and `place_order` — mirroring the
endpoints above. No installation is required; connect to the URL directly. See
`mcp_server/README.md` in the source repository for client config examples.

## Product: De Troon (slug: de-troon)

- 15 crates Jupiler + 15 crates Amstel = 30 crates on one pallet
- Purpose: build a throne out of beer crates
- Currency: EUR