# Decent Espresso

> Decent Espresso Ltd (Hong Kong) designs and sells the Decent espresso machines (DE1PRO, DE1XL, DE1XXL and the upcoming Bengle), plus the Half Decent Scale and coffee accessories: portafilters, baskets, tampers, milk jugs, cups and spare parts. It sells direct, worldwide, from https://decentespresso.com/.

The site is in English, with translations at kr., fr., de., zh-hans., zh-hant. and es.decentespresso.com.

## Using our content, and how to credit it

- Decent's own text and photos on decentespresso.com (product pages, guides, docs and blog) are licensed under Creative Commons Attribution 4.0 (CC BY 4.0, https://creativecommons.org/licenses/by/4.0/). Credit "Decent Espresso" with a link to the page you used.
- Not covered: trademarks and logos (Decent, DE1, Bengle and the Decent logo), content by customers and other third parties (forum and Basecamp posts, reviews, quoted articles, other companies' photos), and software and firmware, which carry their own licences.
- The cocktail section has its own terms: https://decentespresso.com/cocktails/llms.txt
- Details: https://decentespresso.com/license

## MCP server (for AI assistants)

- `https://decentespresso.com/mcp` is a Model Context Protocol server (Streamable HTTP). Add it as a custom connector (remote MCP server) in Claude, ChatGPT or other MCP clients, or: `claude mcp add --transport http decent https://decentespresso.com/mcp`. Opened in a browser, it lists its tools.
- No login is needed for products, prices, cart quotes and the docs/blog (`search_products`, `get_product`, `list_categories`, `quote_cart`, `search_docs`, `read_doc`).
- The person's own orders, machines, payments, addresses, support inbox, file uploads and checkout need their login. MCP clients log in with OAuth (the server announces it; the person signs in and allows the app on decentespresso.com). Clients that don't do OAuth: the `login` tool returns a token, sent as `Authorization: Bearer <token>` (or as a tool's `token` argument). `https://decentespresso.com/mcp/account` asks for the login straight away (use it where a client only offers OAuth when connecting, e.g. claude.ai). Tools that send email say so.
- Paying: `checkout` returns a payment link the person opens. An agent holding a Stripe Shared Payment Token from the person can pay itself (Machine Payments Protocol, MPP): `pay_order` for an order, or `buy` with no login at all (cart, email, name, address).
- Cocktails are a separate MCP server, Decent Cocktails: `https://decentespresso.com/cocktails/mcp` (recipes without an account; Your Bar and a Wishlist with a free one). Details: https://decentespresso.com/cocktails/llms.txt

## Product data

- A free, read-only JSON API covers every machine, accessory and spare part: https://decentespresso.com/api/ (guide), with an [OpenAPI description](https://decentespresso.com/api/openapi.json).
- Search: `GET /api/products?q=basket`. By category: `GET /api/products?category=tampers` (ids from `GET /api/categories`). Spare parts not shown in the shop: add `all=1`.
- One product: `GET /api/products/{sku}`. It returns prices in six currencies, availability, description, weight and dimensions, photos, a cart link, and related products: variants, discounted versions, the parts a kit contains, the kits a part belongs to, and which included machine parts it can replace.
- Names and descriptions follow the host's language (e.g. de.decentespresso.com/api/...). Limit: 120 requests per minute per IP.
- Every product page carries schema.org Product JSON-LD (in a `<script type="application/ld+json">` block): SKU, name, photo, weight, dimensions, materials, and an Offer per currency (USD, EUR, GBP, CAD, AUD, HKD) with availability.
- Availability is approximate (it comes from the last stock count). The cart shows the final price, shipping and duty for the buyer's country.

## Buying for a person

An agent can take a person all the way to paying, with the same steps they would take on the website. The person confirms their email and pays on Stripe's secure page; the agent never handles card details. Full guide: https://decentespresso.com/support/api/#shopping

1. Price the cart: `GET https://decentespresso.com/api/cart/quote?s=75830+2&country=US`. A cart is `NUMBER+QUANTITY` pairs; NUMBER is the product's `cart_number` (the last 5 digits of its SKU, e.g. `DE-304TAMPERV61ALUH-75830` is `75830`). One espresso machine is checked out alone, accessories separately (`can_checkout`, `separate_orders`).
2. `POST /support/api/account/start {"email"}`: we email the person a confirmation link. Nothing is created until they click it.
3. `GET /support/api/account/status?signup_id=...` until `"confirmed"`.
4. `POST /support/api/account/create {"signup_id","name","password"}` returns a token (or, for an existing account, `POST /support/api/login {"email","password"}`). Then send `Authorization: Bearer <token>`.
5. `POST /support/api/addresses`: shipping address, optional billing address.
6. `POST /support/api/checkout {"s":"75830+2"}` returns a `payment_url` and `payment_options` (Stripe card and local methods, or PayPal). Give the person a link to pay.
   An agent with a Stripe Shared Payment Token (MPP, https://mpp.dev) can pay it itself instead: `POST /support/api/orders/{order_id}/pay {"method":"mpp"}` answers `402` with a `WWW-Authenticate: Payment` challenge for the order's total; send the credential in the `Payment-Authorization` header (your login stays in `Authorization`).
7. `GET /support/api/orders/{order_id}`: status, items, address, charges, and each parcel's courier, tracking number and link. `GET /support/api/orders` lists paid orders, `GET /support/api/carts` unpaid carts.

After buying, the same token works for the rest of the customer area (https://decentespresso.com/support/api/#customer): change an order's address or notes, stop it, re-order, pay part or by bank transfer, email a receipt, account settings and password reset, the person's machines and warranty, payment history, messages to Decent support, and nearby Decent ambassadors.

The guide at https://decentespresso.com/support/api/ is public: no account is needed to read it.

Without an account: `https://decentespresso.com/c?s=75830+2` opens the website cart already filled in, for the person to check out themselves.

Without the person's login, paying yourself (MPP, https://mpp.dev): `POST https://decentespresso.com/support/api/buy {"items":[{"product":"75830","quantity":1}], "email", "name", "address":{"phone","address_line_1","city","state","postal_code","country"}}` answers `402` with a `WWW-Authenticate: Payment` challenge (Stripe, charge) for the exact total, and the quote. Pay with a Stripe Shared Payment Token the person granted you and send the same body again with `Authorization: Payment <credential>`: the order is placed and paid, and the person gets the confirmation email (a new email gets an account). Over MCP: the `buy` tool. Discovery: https://decentespresso.com/openapi.json

## Machines

- [Compare the machines](https://decentespresso.com/compare): DE1PRO, DE1XL, DE1XXL and Bengle
- [Prices](https://decentespresso.com/price): machine prices by colour, voltage and region
- [DE1XL](https://decentespresso.com/de1xl)
- [Bengle](https://decentespresso.com/bengle): the 2026 machine, with an integrated scale
- [What's included](https://decentespresso.com/included)
- [Discounted machines](https://decentespresso.com/de1_sale)
- [Warranty](https://decentespresso.com/warranty)
- [FAQs](https://decentespresso.com/faqs): voltage, delivery, repairs, model differences

## Accessories and parts

- [All accessories](https://decentespresso.com/accessories)
- [Coffee accessories](https://decentespresso.com/coffee_accessories)
- [Machine parts](https://decentespresso.com/machine_parts): steam wands, gaskets, water tanks, cables
- [Customize a DE1PRO](https://decentespresso.com/customize)
- [Half Decent Scale](https://decentespresso.com/scale): 0.1 g Bluetooth/Wi-Fi/USB espresso scale, open source
- [Portafilters](https://decentespresso.com/portafilter)
- [Baskets](https://decentespresso.com/baskets), [waisted baskets](https://decentespresso.com/waisted_basket), [ridged and ridgeless baskets](https://decentespresso.com/ridged_ridgeless_basket), [filter baskets](https://decentespresso.com/filter_basket), [other baskets](https://decentespresso.com/other_baskets)
- [Tampers](https://decentespresso.com/tamper)
- [Shower screens](https://decentespresso.com/shower_screen)
- [Group gasket](https://decentespresso.com/gasket)
- [Milk jugs](https://decentespresso.com/milk_jug), [milk thermometer](https://decentespresso.com/milk_thermometer), [pitcher rinser](https://decentespresso.com/rinser)
- [Knockbox](https://decentespresso.com/knockbox)
- [Water refill kit](https://decentespresso.com/refill_kit)
- [Countersink kit](https://decentespresso.com/countersink_kit) and [coffee cart](https://decentespresso.com/coffeecart): built-in installs for DE1XL/XXL
- [Tea portafilter](https://decentespresso.com/tea_portafilter)
- Cups: [Tipsy](https://decentespresso.com/tipsy), [Stacky](https://decentespresso.com/stacky)
- [New products](https://decentespresso.com/new) and [sale items](https://decentespresso.com/sale)

## Guides and documentation

- [Quick start](https://decentespresso.com/quickstart)
- [Guides](https://decentespresso.com/guides)
- [Your first Decent espresso](https://decentespresso.com/first_decent_espresso): dial-in steps
- [Profile guide](https://decentespresso.com/profile_guide)
- [Docs](https://decentespresso.com/docs/) and [blog](https://decentespresso.com/blog/)
- [Search](https://decentespresso.com/search)

## About

- [About us](https://decentespresso.com/about_us)
- [Why Decent](https://decentespresso.com/why)
- [Reviews](https://decentespresso.com/review)
- [Factory cafe, Hong Kong](https://decentespresso.com/factorycafe)
- [Contact](https://decentespresso.com/support/submit)
- [Sitemap](https://decentespresso.com/sitemap.xml)