Ordering cigars through an AI assistant
Anyone may read, only members may buy
The catalogue is open — your assistant can look for a vitola and work out a price without further ado. Ordering needs a Patron Agent Key: an access key you create as a member under Mein Konto and can revoke there at any time. It is shown exactly once, it is yours alone, and it belongs in nobody else's hands.
Create a key under Mein KontoHow it works with Claude
Claude connects to the shop through a custom connector. Anyone on a paid Claude plan can add it themselves.
Server URL:https://www.primos-del-patron.ch/mcp
- Open the settings in Claude and go to Connectors.
- Choose “Add custom connector” and paste in the server URL.
- Enter your Patron Agent Key as the bearer token. Without it the catalogue stays readable, but ordering does not work.
- Enable the connector in a chat and ask about a cigar.
Things you can ask
- Which robustos do you have under 20 francs?
- What does a box of Churchills cost including shipping?
- Order two toros to my saved address.
- How far along is my last order?
And with ChatGPT
ChatGPT speaks the same protocol: the shop is registered there as a connector, with the same server URL and the same key. Buying inside the chat itself (“Instant Checkout”) is currently limited to the United States and selected partners and is not used here — payment always happens on the Stripe page.
What the assistant can do — and cannot
It can
- Search the catalogue — by keyword, strength, format and price, with blend, dimensions and availability.
- Look up a single cigar, by its page or by its identifier.
- Price a cart: single and box prices plus shipping, exactly as the shop calculates it.
- Open an order and hand back the Stripe payment page for it — with your key.
- List your own orders and report where they stand — with your key.
It cannot
- Order without your key. No name and no address in the chat stands in for it.
- See anybody else's orders. A key belongs to exactly one account and sees only that account's orders.
- Pay for you. Only you confirm the payment, on the Stripe page.
- Change your account, open one, or cancel an order.
Privacy
Only what the order needs leaves the chat for the shop: your search terms, the cart and the address you dictate or that sits on your account. A search or a price calculation is not stored. An order comes into being only once a payment page is opened — with the same data as an order placed in a browser. Your key is stored only as a checksum; we cannot read it back.
Read the privacy policyFor developers and reviewers
The shop exposes a Model Context Protocol server. The catalogue and the price calculation are reachable without a login; everything that touches an order wants a Patron Agent Key. An order from the chat runs through the same server-side checkout as an order in the browser: prices are re-read from Firestore, stock is reserved transactionally, and the customer pays on Stripe.
- Endpoint
https://www.primos-del-patron.ch/mcp- Transport
- Streamable HTTP with JSON responses, stateless — one server per request.
- Authentication
- “Authorization: Bearer pdp_…” with a Patron Agent Key. Without the header the catalogue and the price calculation still answer; the remaining tools refuse the call with an explanation rather than failing the handshake.
The six tools
search_cigars- Searches the catalogue by free text, strength, format and price, returning the blend, the dimensions, single and box prices, availability and the product URL.
get_cigar- Reads one cigar by its document id or by the slug of its page — a sold-out one included.
quote_cart- Prices a cart from the cigar documents, shipping included. Stores nothing, holds nothing.
create_checkout- Opens an order and returns the Stripe payment page for it. Requires a Patron Agent Key.
list_orders- Lists the orders of the member the key belongs to — and no one else's.
get_order_status- Returns the state of one of the member's own orders. The address, the gift message and the payment details stay private.
How an order runs
search_cigars or get_cigar for the identifiers, quote_cart for the price, then create_checkout. The delivery address is filled in from the member's account when none is given.
create_checkout charges nothing: it opens an unpaid order, reserves the cigars and returns a Stripe payment page. If it is not paid, the order lapses and the reservation is released.