Suorigo Konfigurátor

–Likes are community signals, not a measured score.

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Potisk triček a textilu na míru (ČR) — katalog, ceny, příprava designu a objednávky.

Author	cz.suorigo.konfigurator
Access	remote
Publisher key required	No
Measured state	Deep-tested
L1 liveness	alive
L1 latency	2194 ms
Last measured	2026-10-24

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Suorigo Konfigurátor": {
      "url": "https://konfigurator.suorigo.cz/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (10)

list_products read-only
Vrátí katalog triček/mikin Suorigo (barvy, velikosti, ceny vč. množstevních slev) nebo jeden produkt podle id/slug.
Parameters:
- product — string — id nebo slug konkrétního produktu (volitelné)
Hints: read-only yes · destructive no · idempotent not declared · open-world no
get_quote read-only
Rychlý odhad ceny JEDNOHO produktu (vč. DPH) podle množství/velikostí a počtu potištěných stran. Přesnou cenu celé objednávky (doprava, kupón, termín) vrací quote_order.
Parameters:
- product (required) — string
- sizes — object — mapování velikost→počet, např. {"M":10,"L":5}
- quantity — number
- promoCode — string
- printedSides — number — počet potištěných stran 0–4
- printSideHeightsCm — array — výška motivu v cm na každé potištěné straně
Hints: read-only yes · destructive no · idempotent not declared · open-world no
create_design
Zvaliduje a uloží design (logo/text na stranách trička): vrátí vrstvy s nahranými URL pro create_order, orientační příplatek za potisk a previewUrl — odkaz, kde zákazník uvidí návrh na tričku v konfigurátoru (a může ho tam i sám objednat).
Parameters:
- product (required) — string
- layers (required) — array — vrstvy: {type:'image'|'text', side:'front'|'back'|'sideLeft'|'sideRight', x,y,width,height v % 0–100, rotation?, src? (https URL nebo data:URL obrázku), text?, fontFamily?, fontSize?, fill?}
- colorId — string
- previewBackDataUrl — string
- previewFrontDataUrl — string
Hints: read-only no · destructive no · idempotent no · open-world no
quote_order read-only
Přesná cena celé objednávky PŘED založením — stejný výpočet jako create_order (položky, doprava vč. dopravy zdarma od 1 500 Kč, kupón, termín výroby). Vrací totalVat, rozpis, dostupné termíny (deliverySpeeds), ceny dopravy a v `requirements` co ještě chybí k objednání. Nic neukládá.
Parameters:
- items (required) — array — položky objednávky (každá velikost/barva zvlášť)
- customer — object — volitelné: email (kvůli limitu kupónu), name, ico, adresy — jen pro kontrolu requirements
- promoCode — string — slevový kód; neplatný kód = chyba (nikdy tiše plná cena)
- shippingId — string — doprava: zasilkovna (výdejní místo / Z-BOX, 89 Kč), balikovna (69 Kč), ppl-vydejni (69 Kč), dpd-vydejni (89 Kč), ppl (na adresu, 119 Kč), dpd (na adresu, 109 Kč); od 1 500 Kč zdarma
- pickupPointId — string — id výdejního místa z find_pickup_points (povinné u dopravy na výdejní místo)
- deliverySpeedId — string — termín: d14 = do 14 prac. dní (výchozí, bez příplatku), d7 = do 7 dní +30 % (jen trička Standard), d30 = do měsíce −10 %; nedostupný termín = 400 s důvodem (quote_order ukáže dostupnost)
- pickupPointName — string — název výdejního místa (volitelné, doplní se samo)
Hints: read-only yes · destructive no · idempotent not declared · open-world no
find_pickup_points read-only
Vyhledá výdejní místa dopravce podle města, PSČ, ulice nebo názvu (Zásilkovna vč. Z-BOXů, Balíkovna, PPL ParcelShop, DPD Pickup). Vrácené `id` patří do create_order.pickupPointId.
Parameters:
- shippingId (required) — string
- query (required) — string — město, PSČ, ulice nebo název (min. 2 znaky), např. „Brno Lidická“ nebo „60200“
- limit — integer — počet výsledků (výchozí 10)
Hints: read-only yes · destructive no · idempotent not declared · open-world yes
lookup_company read-only
Dohledá firmu podle IČO v ARES (název, DIČ, sídlo) — pro nákup na firmu. Vrací pole ve tvaru create_order.customer (companyName, ico, dic, billingStreet…).
Parameters:
- ico (required) — string — IČO (7–8 číslic)
Hints: read-only yes · destructive no · idempotent not declared · open-world yes
create_order
Založí ZÁVAZNOU objednávku (čeká na platbu). paymentMethod 'bank_transfer' (výchozí) vrátí číslo účtu, variabilní symbol a QR; 'card' vrátí paymentUrl — zabezpečenou stránku Stripe pro tuto objednávku, kde zákazník sám zadá kartu (agent kartu nikdy nezadává ani nevidí; po zaplacení jede faktura a výroba stejně jako u objednávky z webu). Vždy vrátí statusUrl a statusToken (pro get_order_status, get_payment_link, cancel_order) a zákazníkovi pošle e-mail. Volej až po výslovném souhlasu zákazníka s položkami a cenou z quote_order. Povinné: skutečný e-mail (doména musí přijímat poštu, jinak 422), jméno a příjmení, shippingId (+ pickupPointId u výdejního místa, jinak adresa), consent:true; nad 10 000 Kč bez IČO fakturační adresa. Kartou nejméně 15 Kč. Nezaplacená karta propadne po 48 h, převod po 7 dnech. Limity: 3 objednávky / IP / den, 2 nezaplacené a 3 objednávky za 24 h na e-mail (429). Při opakování po timeoutu pošli stejný idempotencyKey.
Parameters:
- items (required) — array — položky objednávky (každá velikost/barva zvlášť)
- customer (required) — object — zákazník: email (povinné, skutečná doména s poštou), name (povinné — jméno A příjmení, jde na daňový doklad), phone?, address? (doručovací adresa jedním řádkem u doručení na adresu) nebo deliveryStreet/deliveryCity/deliveryZip, firma: companyName?, ico? (doplní se z ARES), dic?, fakturační adresa billingStreet/billingCity/billingZip/billingCountry (nad 10 000 Kč bez IČO povinná)
- shippingId (required) — string — doprava: zasilkovna (výdejní místo / Z-BOX, 89 Kč), balikovna (69 Kč), ppl-vydejni (69 Kč), dpd-vydejni (89 Kč), ppl (na adresu, 119 Kč), dpd (na adresu, 109 Kč); od 1 500 Kč zdarma
- consent (required) — boolean — souhlas zákazníka s obchodními podmínkami (https://suorigo.cz/obchodni-podminky), musí být true
- notes — string — vzkaz zákazníka k objednávce (co má dílna vědět); uloží se k zakázce jako poznámka od zákazníka, delší text se ořízne
- promoCode — string — slevový kód; neplatný kód = chyba (nikdy tiše plná cena)
- paymentMethod — string — bank_transfer = převod + QR (výchozí); card = odkaz na platbu kartou (Stripe Checkout, Apple/Google Pay podle prohlížeče)
- pickupPointId — string — id výdejního místa z find_pickup_points (povinné u dopravy na výdejní místo)
- idempotencyKey — string — libovolný unikátní klíč této objednávky (např. UUID); opakované volání se stejným klíčem a obsahem vrátí stejnou objednávku (replayed:true, u karty tentýž platební odkaz), stejný klíč s jiným obsahem = 409
- deliverySpeedId — string — termín: d14 = do 14 prac. dní (výchozí, bez příplatku), d7 = do 7 dní +30 % (jen trička Standard), d30 = do měsíce −10 %; nedostupný termín = 400 s důvodem (quote_order ukáže dostupnost)
- pickupPointName — string — název výdejního místa (volitelné, doplní se samo)
Hints: read-only no · destructive no · idempotent yes · open-world yes
get_payment_link
Vrátí odkaz na zaplacení existující objednávky kartou (paymentUrl na Stripe) — když zákazník odkaz ztratil nebo vypršel (platí ~24 h). Stejná cesta jako tlačítko „Dokončit platbu kartou“ na webu: otevřenou platbu znovu použije, zaplacenou jen potvrdí, rozpracované ověření v bance nechá doběhnout. Jen pro objednávky kartou (převod má platební údaje v create_order). Autorizace: statusToken → vrátí paymentUrl; orderNumber + email → odkaz NEvrací, pošle ho zákazníkovi na e-mail z objednávky (max 1× / 15 min, 3× / den).
Parameters:
- email — string — e-mail zákazníka z objednávky — jen spolu s orderNumber
- orderNumber — string — číslo objednávky (9 číslic) — jen spolu s e-mailem
- statusToken — string — statusToken z create_order (poslední část statusUrl) — plný přístup
Hints: read-only no · destructive no · idempotent yes · open-world yes
get_order_status read-only
Stav objednávky: platba (pending/paid/failed/refunded), výroba (new → shipped/delivered, cancelled), očekávaný termín. Se statusToken navíc statusUrl, faktura (PDF po zaplacení) a sledování zásilky. S orderNumber + email jen základní stav (čísla objednávek jsou předvídatelná). Neshoda = found:false.
Parameters:
- email — string — e-mail zákazníka z objednávky — jen spolu s orderNumber
- orderNumber — string — číslo objednávky (9 číslic) — jen spolu s e-mailem
- statusToken — string — statusToken z create_order (poslední část statusUrl) — plný přístup
Hints: read-only yes · destructive no · idempotent not declared · open-world yes
cancel_order destructive
Stornuje NEZAPLACENOU objednávku, která ještě není ve výrobě — stejně jako tlačítko na stránce stavu (zákazník dostane e-mail o stornu, otevřená platba kartou se zavře). Zaplacenou objednávku stornovat nejde (napiš na [email protected]). Jen se statusToken a jen na výslovný pokyn zákazníka.
Parameters:
- statusToken (required) — string — statusToken z create_order (poslední část statusUrl) — plný přístup
Hints: read-only no · destructive yes · idempotent yes · open-world yes

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.