MCP Server
Pinflower — flowers in Prague
cz.pinflower/flowers
What this MCP does
Searches Prague florist bouquets, checks delivery availability and pricing, and supports payment-link ordering, status checks, rescheduling, and cancellation.
Capabilities
Tools
9
tools
pinflower_cancel_order
Cancel an order
Use this when the buyer explicitly asks to cancel an order placed through pinflower_create_order. The website's rules apply: free while the florist has not confirmed, and for a later-day order until the cut-off before its time window; a paid amount is refunded in full. Two steps: call with order_ref and confirm=true — a 6-digit code goes to the e-mail the order was placed with; then call again with the code the buyer reads from that e-mail. Not for changing an order — cancel and order again.
Destructive
Idempotent
Input schema
{'type': 'object', 'required': ['order_ref', 'confirm'], 'properties': {'code': {'type': 'string', 'description': 'The 6-digit code from the e-mail (second call).'}, 'confirm': {'type': 'boolean', 'description': 'true only after the buyer confirmed they want to cancel.'}, 'order_ref': {'type': 'string'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['order_ref', 'cancelled'], 'properties': {'cancelled': {'type': 'boolean'}, 'order_ref': {'type': 'string'}, 'code_sent_to': {'type': 'string'}, 'refunded_czk': {'type': ['number', 'null']}}}
pinflower_check_delivery
Check delivery to a place
Use this when the buyer asks whether Pinflower delivers to a place in Prague, how much delivery costs, how soon it can arrive, or whether flowers can come tonight — before choosing a bouquet. Pass the place as the buyer said it. Not needed when you are already searching bouquets for that place.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['where'], 'properties': {'date': {'type': 'string', 'description': "Delivery/pickup day: 'today', 'tomorrow' or YYYY-MM-DD (Prague). Omit for as soon as possible."}, 'where': {'type': 'string', 'description': "Where the flowers go, as the buyer said it: a Prague district ('Praha 5'), a quarter ('Vinohrady', 'Smíchov') or a street address. Omit when unknown."}, 'locale': {'enum': ['cs', 'en', 'ru', 'uk'], 'type': 'string', 'description': "The buyer's language for names, texts and links: cs, en, ru or uk (default cs)."}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['can_deliver'], 'properties': {'place': {'type': 'string'}, 'earliest': {'type': ['object', 'null'], 'properties': {'day': {'enum': ['today', 'tomorrow', 'later'], 'type': 'string'}, 'asap': {'type': 'boolean'}, 'date': {'type': 'string'}, 'time': {'type': 'string'}}}, 'florists': {'type': 'integer'}, 'can_deliver': {'type': 'boolean'}, 'night_delivery': {'type': 'boolean'}, 'delivery_fee_from_czk': {'type': ['number', 'null']}}}
pinflower_create_order
Order bouquets (pay on pinflower.cz)
Use this when the buyer has agreed to the total from pinflower_quote_order: it creates the order exactly like the website's checkout and returns the secure payment link on pinflower.cz. Pass the same arguments as the quote, terms_accepted=true and confirmed_total_czk = the total the buyer agreed to; if the total has changed meanwhile, nothing is created and you get the new breakdown to read back. Collect first: the bouquet(s) (bouquet_id from search; several bouquets of ONE florist with quantities in items); delivery or pickup; for delivery the street address with house number in Prague; the recipient's name and phone when someone else receives the flowers; the date and a time (one of the times pinflower_get_bouquet offers, or 'asap'); the buyer's name, e-mail and phone (+420…); an optional card message and note for the florist; and ask whether they have a promo code. Above 10 000 Kč the buyer's billing address is required. Also on offer: address_mode 'ask_recipient' when the florist should agree the address with the recipient by phone — a surprise (the recipient's name and phone are then required); time 'agree_with_recipient' when the florist should agree the time with the recipient by phone (the recipient's name and phone are then required); ask whether it is a purchase for a company (IČO). Nothing is charged here and the florist is not told until the buyer pays.
Destructive
Input schema
{'type': 'object', 'required': ['date', 'time', 'buyer', 'terms_accepted', 'confirmed_total_czk', 'order_intent'], 'properties': {'date': {'type': 'string', 'description': "'today', 'tomorrow' or YYYY-MM-DD."}, 'time': {'type': 'string', 'description': "HH:MM from the offered times, or 'asap', or 'agree_with_recipient' (the florist agrees the time with the recipient by phone; delivery only)."}, 'unit': {'type': 'string', 'maxLength': 80, 'description': 'Apartment, floor, company at the door.'}, 'buyer': {'type': 'object', 'required': ['name', 'email', 'phone'], 'properties': {'name': {'type': 'string', 'description': 'First name (or the full name).'}, 'email': {'type': 'string'}, 'phone': {'type': 'string', 'description': '+420…'}, 'last_name': {'type': 'string'}}, 'additionalProperties': False}, 'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'addons': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Add-on keys the bouquet offers (pinflower_get_bouquet → addons).'}, 'quantity': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'How many of this bouquet (default 1).'}, 'bouquet_id': {'type': 'string', 'description': 'From pinflower_search_bouquets / pinflower_get_bouquet.'}, 'custom_budget_czk': {'type': 'integer', 'maximum': 2400, 'minimum': 390, 'description': 'A bouquet composed by the florist to a budget (390–2400 Kč) instead of bouquet_id; put the wishes into florist_note.'}}, 'additionalProperties': False}, 'maxItems': 10, 'minItems': 1, 'description': 'Several bouquets from the SAME florist, with quantities.'}, 'locale': {'enum': ['cs', 'en', 'ru', 'uk'], 'type': 'string'}, 'address': {'type': 'string', 'description': 'Delivery to a known address: street and house number in Prague.'}, 'company': {'type': 'object', 'required': ['name', 'ico'], 'properties': {'dic': {'type': 'string'}, 'ico': {'type': 'string', 'description': 'Czech company ID (IČO, 8 digits).'}, 'name': {'type': 'string'}, 'address': {'type': 'string'}}, 'description': 'Buying for a company — the invoice is issued to it.', 'additionalProperties': False}, 'recipient': {'type': 'object', 'required': ['name', 'phone'], 'properties': {'name': {'type': 'string'}, 'phone': {'type': 'string', 'description': '+420…'}, 'sms_opt_out': {'type': 'boolean', 'description': 'true = no SMS to the recipient (keeps a surprise).'}}, 'description': 'Who receives the flowers, when it is someone else than the buyer — the courier calls them.', 'additionalProperties': False}, 'bouquet_id': {'type': 'string', 'description': 'One bouquet (shortcut for items with a single line).'}, 'florist_id': {'type': 'string', 'description': 'The florist — needed only when the order is a custom bouquet alone.'}, 'fulfilment': {'enum': ['delivery', 'pickup'], 'type': 'string'}, 'promo_code': {'type': 'string', 'maxLength': 64, 'description': "The buyer's promo code, if they have one — works for guests and signed-in buyers alike; the checkout checks it."}, 'address_mode': {'enum': ['known', 'ask_recipient'], 'type': 'string', 'description': 'ask_recipient = the courier/florist agrees the address with the recipient by phone (a surprise); no address needed, delivery priced at the whole-city rate.'}, 'card_message': {'type': 'string', 'maxLength': 240}, 'courier_note': {'type': 'string', 'maxLength': 200, 'description': 'Bell name, entrance, gate code.'}, 'florist_note': {'type': 'string', 'maxLength': 500}, 'order_intent': {'type': 'string', 'description': 'order_intent from pinflower_quote_order. Retrying this call (e.g. the answer got lost) keeps it — the same order comes back; a new purchase needs a new quote.'}, 'terms_accepted': {'type': 'boolean', 'description': 'true only after the buyer agreed to the terms.'}, 'billing_address': {'type': 'string', 'maxLength': 200, 'description': "The buyer's billing address — required by Czech tax rules when the order is over 10 000 Kč (unless buying for a company)."}, 'marketing_opt_in': {'type': 'boolean', 'description': 'Only true if the buyer asked for news and offers.'}, 'confirmed_total_czk': {'type': 'integer', 'minimum': 0, 'description': 'total_czk from pinflower_quote_order that the buyer agreed to — a different total refuses the order.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['order_ref', 'total_czk', 'pay_url'], 'properties': {'pay_url': {'type': 'string'}, 'order_ref': {'type': 'string'}, 'total_czk': {'type': 'number'}, 'order_number': {'type': ['integer', 'null']}}}
pinflower_get_bouquet
Bouquet details and times
Use this when the buyer is interested in one bouquet from pinflower_search_bouquets: what is inside, its size, photos, the florist's rating, the price with delivery (exact for a street address — delivery_fee_exact says so; otherwise the shop's typical fee) and every time it can arrive on a given day. Needs bouquet_id from a search. Not for comparing many bouquets — search does that.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['bouquet_id'], 'properties': {'date': {'type': 'string', 'description': "Delivery/pickup day: 'today', 'tomorrow' or YYYY-MM-DD (Prague). Omit for as soon as possible."}, 'where': {'type': 'string', 'description': "Where the flowers go, as the buyer said it: a Prague district ('Praha 5'), a quarter ('Vinohrady', 'Smíchov') or a street address. Omit when unknown."}, 'locale': {'enum': ['cs', 'en', 'ru', 'uk'], 'type': 'string', 'description': "The buyer's language for names, texts and links: cs, en, ru or uk (default cs)."}, 'bouquet_id': {'type': 'string'}, 'fulfilment': {'enum': ['delivery', 'pickup'], 'type': 'string', 'description': "delivery (default) or pickup at the florist's shop."}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['bouquet_id', 'name'], 'properties': {'name': {'type': 'string'}, 'slots': {'type': 'object'}, 'bouquet_id': {'type': 'string'}}}
pinflower_get_order_status
Order status
Use this when the buyer asks what is happening with an order placed through pinflower_create_order — whether it is paid, confirmed by the florist, on the way or delivered. Needs the order_ref that pinflower_create_order returned. It changes nothing — for a new payment link use pinflower_new_pay_link, to cancel pinflower_cancel_order.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['order_ref'], 'properties': {'locale': {'enum': ['cs', 'en', 'ru', 'uk'], 'type': 'string', 'description': "The buyer's language for names, texts and links: cs, en, ru or uk (default cs)."}, 'order_ref': {'type': 'string'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['order_ref', 'step', 'paid'], 'properties': {'paid': {'type': 'boolean'}, 'step': {'type': 'string'}, 'order_ref': {'type': 'string'}}}
pinflower_new_pay_link
Payment link again
Use this when the buyer has not paid yet and the payment link from pinflower_create_order expired or got lost: it returns the order's payable link on pinflower.cz — the same one while it is still open (never a second payable link). Needs the order_ref. Not for paid or cancelled orders.
Destructive
Idempotent
Input schema
{'type': 'object', 'required': ['order_ref'], 'properties': {'order_ref': {'type': 'string'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['order_ref', 'pay_url'], 'properties': {'pay_url': {'type': 'string'}, 'order_ref': {'type': 'string'}}}
pinflower_quote_order
Price the order
Use this when the buyer has chosen what to order and you have the details: it prices the order exactly as the checkout will charge it — the bouquet(s), add-ons, the shop's launch discount or the buyer's promo code, the delivery fee — and checks the time, without creating anything. Collect first: the bouquet(s) (bouquet_id from search; several bouquets of ONE florist with quantities in items); delivery or pickup; for delivery the street address with house number in Prague; the recipient's name and phone when someone else receives the flowers; the date and a time (one of the times pinflower_get_bouquet offers, or 'asap'); the buyer's name, e-mail and phone (+420…); an optional card message and note for the florist; and ask whether they have a promo code. Above 10 000 Kč the buyer's billing address is required. Also on offer: address_mode 'ask_recipient' when the florist should agree the address with the recipient by phone — a surprise (the recipient's name and phone are then required); time 'agree_with_recipient' when the florist should agree the time with the recipient by phone (the recipient's name and phone are then required); ask whether it is a purchase for a company (IČO). Read the breakdown and the terms link back to the buyer; after their yes call pinflower_create_order with the same arguments, terms_accepted=true and confirmed_total_czk. Call it again after any change.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['date', 'time', 'buyer'], 'properties': {'date': {'type': 'string', 'description': "'today', 'tomorrow' or YYYY-MM-DD."}, 'time': {'type': 'string', 'description': "HH:MM from the offered times, or 'asap', or 'agree_with_recipient' (the florist agrees the time with the recipient by phone; delivery only)."}, 'unit': {'type': 'string', 'maxLength': 80, 'description': 'Apartment, floor, company at the door.'}, 'buyer': {'type': 'object', 'required': ['name', 'email', 'phone'], 'properties': {'name': {'type': 'string', 'description': 'First name (or the full name).'}, 'email': {'type': 'string'}, 'phone': {'type': 'string', 'description': '+420…'}, 'last_name': {'type': 'string'}}, 'additionalProperties': False}, 'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'quantity': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'How many of this bouquet (default 1).'}, 'bouquet_id': {'type': 'string', 'description': 'From pinflower_search_bouquets / pinflower_get_bouquet.'}}, 'additionalProperties': False}, 'maxItems': 10, 'minItems': 1, 'description': 'Several bouquets from the SAME florist, with quantities.'}, 'locale': {'enum': ['cs', 'en', 'ru', 'uk'], 'type': 'string'}, 'address': {'type': 'string', 'description': 'Delivery to a known address: street and house number in Prague.'}, 'company': {'type': 'object', 'required': ['name', 'ico'], 'properties': {'dic': {'type': 'string'}, 'ico': {'type': 'string', 'description': 'Czech company ID (IČO, 8 digits).'}, 'name': {'type': 'string'}, 'address': {'type': 'string'}}, 'description': 'Buying for a company — the invoice is issued to it.', 'additionalProperties': False}, 'recipient': {'type': 'object', 'required': ['name', 'phone'], 'properties': {'name': {'type': 'string'}, 'phone': {'type': 'string', 'description': '+420…'}}, 'description': 'Who receives the flowers, when it is someone else than the buyer — the courier calls them.', 'additionalProperties': False}, 'bouquet_id': {'type': 'string', 'description': 'One bouquet (shortcut for items with a single line).'}, 'fulfilment': {'enum': ['delivery', 'pickup'], 'type': 'string'}, 'promo_code': {'type': 'string', 'maxLength': 64, 'description': "The buyer's promo code, if they have one — works for guests and signed-in buyers alike; the checkout checks it."}, 'address_mode': {'enum': ['known', 'ask_recipient'], 'type': 'string', 'description': 'ask_recipient = the courier/florist agrees the address with the recipient by phone (a surprise); no address needed, delivery priced at the whole-city rate.'}, 'card_message': {'type': 'string', 'maxLength': 240}, 'courier_note': {'type': 'string', 'maxLength': 200, 'description': 'Bell name, entrance, gate code.'}, 'florist_note': {'type': 'string', 'maxLength': 500}, 'billing_address': {'type': 'string', 'maxLength': 200, 'description': "The buyer's billing address — required by Czech tax rules when the order is over 10 000 Kč (unless buying for a company)."}, 'marketing_opt_in': {'type': 'boolean', 'description': 'Only true if the buyer asked for news and offers.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['goods_czk', 'delivery_fee_czk', 'total_czk', 'terms_url', 'next_step'], 'properties': {'discount': {'type': 'object'}, 'goods_czk': {'type': 'number'}, 'next_step': {'type': 'string'}, 'terms_url': {'type': 'string'}, 'total_czk': {'type': 'number'}, 'delivery_fee_czk': {'type': 'number'}}}
pinflower_search_bouquets
Find bouquets
Use this when the buyer wants flowers delivered in Prague (or picked up there) and you need concrete bouquets: it returns only bouquets that can really arrive at the given place and time, with price, delivery fee, total and the earliest delivery time, in the storefront's recommended order. Pass what the buyer said: free text, occasion, budget, where, date and a deliver-by time. Do not use it for general flower advice or for orders outside Prague. Show 3–6 results; then use pinflower_get_bouquet for details or pinflower_create_order to order.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'date': {'type': 'string', 'description': "Delivery/pickup day: 'today', 'tomorrow' or YYYY-MM-DD (Prague). Omit for as soon as possible."}, 'sort': {'enum': ['recommended', 'price_asc', 'price_desc', 'fastest'], 'type': 'string', 'description': "recommended (default, the storefront's order), cheapest, most expensive, or soonest arrival."}, 'limit': {'type': 'integer', 'maximum': 8, 'minimum': 1, 'description': 'How many results (default 6).'}, 'query': {'type': 'string', 'description': "Free text in any language: flower, colour or bouquet name, e.g. 'red roses', 'tulipány', 'пионы'."}, 'style': {'enum': ['as_pictured', 'florists_style'], 'type': 'string', 'description': 'as_pictured = looks like the photo; florists_style = composed fresh by the florist in that spirit.'}, 'where': {'type': 'string', 'description': "Where the flowers go, as the buyer said it: a Prague district ('Praha 5'), a quarter ('Vinohrady', 'Smíchov') or a street address. Omit when unknown."}, 'detail': {'enum': ['short', 'full'], 'type': 'string', 'description': 'full adds composition and a short description (default short).'}, 'locale': {'enum': ['cs', 'en', 'ru', 'uk'], 'type': 'string', 'description': "The buyer's language for names, texts and links: cs, en, ru or uk (default cs)."}, 'category': {'type': 'string', 'description': 'A category slug as results show it (e.g. roses, tulips).'}, 'currency': {'enum': ['czk', 'eur', 'usd'], 'type': 'string', 'description': 'Add an approximate EUR/USD preview for a buyer abroad (default czk). The charge is always in CZK.'}, 'occasion': {'enum': ['birthday', 'name_day', 'romance', 'anniversary', 'apology', 'sympathy', 'thank_you', 'new_baby'], 'type': 'string', 'description': "Only when the buyer named the occasion. Never assume 'sympathy'."}, 'ready_now': {'type': 'boolean', 'description': 'Only bouquets already made and waiting (fastest).'}, 'deliver_by': {'type': 'string', 'description': 'HH:MM (24 h): must arrive by then. Without date it means today.'}, 'fulfilment': {'enum': ['delivery', 'pickup'], 'type': 'string', 'description': "delivery (default) or pickup at the florist's shop."}, 'free_delivery': {'type': 'boolean', 'description': 'Only bouquets with free delivery.'}, 'budget_max_czk': {'type': 'number', 'minimum': 0, 'description': 'Bouquet price limit in CZK (delivery not included).'}, 'budget_min_czk': {'type': 'number', 'minimum': 0}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['interpreted', 'results', 'total_found'], 'properties': {'empty': {'type': 'object', 'properties': {'reason': {'type': 'string'}, 'next_step': {'type': 'string'}}}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['bouquet_id', 'name', 'florist', 'price_czk', 'total_czk', 'url'], 'properties': {'url': {'type': 'string'}, 'name': {'type': 'string'}, 'florist': {'type': 'string'}, 'earliest': {'type': ['object', 'null'], 'properties': {'day': {'enum': ['today', 'tomorrow', 'later'], 'type': 'string'}, 'asap': {'type': 'boolean'}, 'date': {'type': 'string'}, 'time': {'type': 'string'}}}, 'image_url': {'type': ['string', 'null']}, 'price_czk': {'type': 'number'}, 'total_czk': {'type': 'number'}, 'bouquet_id': {'type': 'string'}, 'delivery_fee_czk': {'type': ['number', 'null']}}}}, 'currency': {'type': 'string'}, 'interpreted': {'type': 'object'}, 'total_found': {'type': 'integer'}}}
pinflower_store_info
How Pinflower works
Use this when the buyer asks how ordering works: payment and when the card is charged, delivery area and fees, anonymous delivery and the card message, what happens if nobody is home, returns and complaints, or how to contact Pinflower. Answers come from the shop's own pages, with links. Not for bouquet availability — use search for that.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'locale': {'enum': ['cs', 'en', 'ru', 'uk'], 'type': 'string', 'description': "The buyer's language for names, texts and links: cs, en, ru or uk (default cs)."}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['faq', 'links'], 'properties': {'faq': {'type': 'array'}, 'facts': {'type': 'object'}, 'links': {'type': 'object'}}}
History
Recent tool changes
Changed
pinflower_quote_order
Sept. 29, 2026, 2:48 a.m.
Changed
pinflower_new_pay_link
Sept. 29, 2026, 2:48 a.m.
Changed
pinflower_get_bouquet
Sept. 29, 2026, 2:48 a.m.
Changed
pinflower_create_order
Sept. 29, 2026, 2:48 a.m.
Added
pinflower_store_info
Sept. 27, 2026, 2:40 a.m.
Added
pinflower_search_bouquets
Sept. 27, 2026, 2:40 a.m.
Added
pinflower_quote_order
Sept. 27, 2026, 2:40 a.m.
Added
pinflower_new_pay_link
Sept. 27, 2026, 2:40 a.m.
Added
pinflower_get_order_status
Sept. 27, 2026, 2:40 a.m.
Added
pinflower_get_bouquet
Sept. 27, 2026, 2:40 a.m.
Added
pinflower_create_order
Sept. 27, 2026, 2:40 a.m.
Added
pinflower_check_delivery
Sept. 27, 2026, 2:40 a.m.
Added
pinflower_cancel_order
Sept. 27, 2026, 2:40 a.m.
Discover
Similar MCP servers
AgentLot Marketplace
io.agentlot/marketplace
Enables agents and users to discover, bid on, purchase, deliver, and settle paid digital services and compute work.
apex-x1
xyz.apexfaucet/apex-x1
Provides X1 and Arc token screening, liquidity and exit-risk checks, wallet and bridge data, non-custodial token operations, comm…
SpellBook Finance
com.spellbook-finance/mcp
Provides Magic: The Gathering and other trading-card market prices, buylist offers, arbitrage analysis, sealed-product EV, seller…
API Direct
io.apidirect/api-direct
Searches and retrieves data from social networks, news and Google services, while also providing Amazon product, seller, ranking,…
Digital Manager Guru
io.github.mcp-dir/guru-mcp
Provides Digital Manager Guru checkout, customer, transaction, subscription, affiliate, coupon, blocklist, and digital-product sa…
Pagar.me
io.github.mcp-dir/pagarme-mcp
Connects to Pagar.me to manage customers, cards, orders, charges, invoices, payment captures, confirmations, retries, refunds, an…
amazon-product-research-mcp
com.webotee/amazon-product-research-mcp
Researches Amazon products, brands, sellers, buy-box activity, sourcing profitability, category competition, and supplier opportu…
AgentLux
io.github.agentlux/agentlux
Operates an agent avatar marketplace with item generation, purchases, creator earnings, public profiles, social activity, and ERC…