Server definition
- Hash
- sha256:947e5e6fa83de039c4e220f379353953a677d4bb66eae3c761cfae7f1101a9fa
- What it is
- What a remote MCP server returned when asked what it offers: 10 tools
The blob, as servednamed by its sha256
{
"instructions": "Suorigo — potisk triček/mikin na míru (Česko). Agent tu objedná stejně jako člověk v pokladně: list_products → (create_design pro logo/text, vrátí i previewUrl s náhledem) → find_pickup_points (výdejní místo) / lookup_company (firma podle IČO) → quote_order (přesná cena vč. dopravy, kupónu a termínu) → po výslovném souhlasu zákazníka create_order → get_order_status / get_payment_link / cancel_order. Ceny v Kč vč. DPH. Platba: paymentMethod 'bank_transfer' (číslo účtu + VS + QR) nebo 'card' (paymentUrl — zákazník zaplatí kartou na stránce Stripe; agent kartu nikdy nezadává). create_order je ZÁVAZNÉ: skutečný e-mail, jméno a příjmení, doprava, consent:true; při opakování po timeoutu stejný idempotencyKey. Limity: 60 volání / 10 min, 3 objednávky / IP / den, 2 nezaplacené a 3 objednávky za 24 h na e-mail. Dokumentace: https://konfigurator.suorigo.cz/api/docs (OpenAPI: /api/openapi.json), pravidla: https://suorigo.cz/agents.md.",
"tools": [
{
"description": "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.",
"inputSchema": {
"properties": {
"statusToken": {
"description": "statusToken z create_order (poslední část statusUrl) — plný přístup",
"type": "string"
}
},
"required": [
"statusToken"
],
"type": "object"
},
"name": "cancel_order",
"outputSchema": null
},
{
"description": "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).",
"inputSchema": {
"properties": {
"colorId": {
"type": "string"
},
"layers": {
"description": "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?}",
"items": {
"type": "object"
},
"type": "array"
},
"previewBackDataUrl": {
"type": "string"
},
"previewFrontDataUrl": {
"type": "string"
},
"product": {
"type": "string"
}
},
"required": [
"product",
"layers"
],
"type": "object"
},
"name": "create_design",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"consent": {
"description": "souhlas zákazníka s obchodními podmínkami (https://suorigo.cz/obchodni-podminky), musí být true",
"type": "boolean"
},
"customer": {
"description": "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á)",
"properties": {
"address": {
"type": "string"
},
"billingCity": {
"type": "string"
},
"billingCountry": {
"type": "string"
},
"billingStreet": {
"type": "string"
},
"billingZip": {
"type": "string"
},
"companyName": {
"type": "string"
},
"deliveryCity": {
"type": "string"
},
"deliveryStreet": {
"type": "string"
},
"deliveryZip": {
"type": "string"
},
"dic": {
"type": "string"
},
"email": {
"type": "string"
},
"ico": {
"type": "string"
},
"name": {
"type": "string"
},
"phone": {
"type": "string"
}
},
"required": [
"email",
"name"
],
"type": "object"
},
"deliverySpeedId": {
"description": "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)",
"enum": [
"d7",
"d14",
"d30"
],
"type": "string"
},
"idempotencyKey": {
"description": "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",
"maxLength": 128,
"type": "string"
},
"items": {
"description": "položky objednávky (každá velikost/barva zvlášť)",
"items": {
"properties": {
"colorId": {
"type": "string"
},
"colorName": {
"description": "název barvy",
"type": "string"
},
"layers": {
"description": "vrstvy z create_design (určují příplatek za potisk)",
"items": {
"type": "object"
},
"type": "array"
},
"printMethod": {
"type": "string"
},
"product": {
"description": "id nebo slug produktu z list_products",
"type": "string"
},
"quantity": {
"minimum": 1,
"type": "integer"
},
"size": {
"description": "velikost z katalogu, např. M",
"type": "string"
}
},
"required": [
"product",
"size",
"quantity"
],
"type": "object"
},
"type": "array"
},
"notes": {
"description": "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",
"maxLength": 1000,
"type": "string"
},
"paymentMethod": {
"description": "bank_transfer = převod + QR (výchozí); card = odkaz na platbu kartou (Stripe Checkout, Apple/Google Pay podle prohlížeče)",
"enum": [
"bank_transfer",
"card"
],
"type": "string"
},
"pickupPointId": {
"description": "id výdejního místa z find_pickup_points (povinné u dopravy na výdejní místo)",
"type": "string"
},
"pickupPointName": {
"description": "název výdejního místa (volitelné, doplní se samo)",
"type": "string"
},
"promoCode": {
"description": "slevový kód; neplatný kód = chyba (nikdy tiše plná cena)",
"type": "string"
},
"shippingId": {
"description": "doprava: zasilkovna (výdejní místo / Z-BOX, 89 Kč), balikovna (69 Kč), ppl-vydejni (79 Kč), dpd-vydejni (89 Kč), ppl / dpd (na adresu, 129 Kč); od 1 500 Kč zdarma; osobni (Šitbořice) jen se slevovým kódem, který ho odemyká",
"enum": [
"zasilkovna",
"balikovna",
"ppl-vydejni",
"dpd-vydejni",
"ppl",
"dpd",
"osobni"
],
"type": "string"
}
},
"required": [
"items",
"customer",
"shippingId",
"consent"
],
"type": "object"
},
"name": "create_order",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"limit": {
"description": "počet výsledků (výchozí 10)",
"maximum": 25,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "město, PSČ, ulice nebo název (min. 2 znaky), např. „Brno Lidická“ nebo „60200“",
"type": "string"
},
"shippingId": {
"enum": [
"zasilkovna",
"balikovna",
"ppl-vydejni",
"dpd-vydejni"
],
"type": "string"
}
},
"required": [
"shippingId",
"query"
],
"type": "object"
},
"name": "find_pickup_points",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"email": {
"description": "e-mail zákazníka z objednávky — jen spolu s orderNumber",
"type": "string"
},
"orderNumber": {
"description": "číslo objednávky (9 číslic) — jen spolu s e-mailem",
"type": "string"
},
"statusToken": {
"description": "statusToken z create_order (poslední část statusUrl) — plný přístup",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "get_order_status",
"outputSchema": null
},
{
"description": "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).",
"inputSchema": {
"properties": {
"email": {
"description": "e-mail zákazníka z objednávky — jen spolu s orderNumber",
"type": "string"
},
"orderNumber": {
"description": "číslo objednávky (9 číslic) — jen spolu s e-mailem",
"type": "string"
},
"statusToken": {
"description": "statusToken z create_order (poslední část statusUrl) — plný přístup",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "get_payment_link",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"printSideHeightsCm": {
"description": "výška motivu v cm na každé potištěné straně",
"items": {
"type": "number"
},
"type": "array"
},
"printedSides": {
"description": "počet potištěných stran 0–4",
"type": "number"
},
"product": {
"type": "string"
},
"promoCode": {
"type": "string"
},
"quantity": {
"type": "number"
},
"sizes": {
"description": "mapování velikost→počet, např. {\"M\":10,\"L\":5}",
"type": "object"
}
},
"required": [
"product"
],
"type": "object"
},
"name": "get_quote",
"outputSchema": null
},
{
"description": "Vrátí katalog triček/mikin Suorigo (barvy, velikosti, ceny vč. množstevních slev) nebo jeden produkt podle id/slug.",
"inputSchema": {
"properties": {
"product": {
"description": "id nebo slug konkrétního produktu (volitelné)",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "list_products",
"outputSchema": null
},
{
"description": "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…).",
"inputSchema": {
"properties": {
"ico": {
"description": "IČO (7–8 číslic)",
"type": "string"
}
},
"required": [
"ico"
],
"type": "object"
},
"name": "lookup_company",
"outputSchema": null
},
{
"description": "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á.",
"inputSchema": {
"properties": {
"customer": {
"description": "volitelné: email (kvůli limitu kupónu), name, ico, adresy — jen pro kontrolu requirements",
"type": "object"
},
"deliverySpeedId": {
"description": "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)",
"enum": [
"d7",
"d14",
"d30"
],
"type": "string"
},
"items": {
"description": "položky objednávky (každá velikost/barva zvlášť)",
"items": {
"properties": {
"colorId": {
"type": "string"
},
"colorName": {
"description": "název barvy",
"type": "string"
},
"layers": {
"description": "vrstvy z create_design (určují příplatek za potisk)",
"items": {
"type": "object"
},
"type": "array"
},
"printMethod": {
"type": "string"
},
"product": {
"description": "id nebo slug produktu z list_products",
"type": "string"
},
"quantity": {
"minimum": 1,
"type": "integer"
},
"size": {
"description": "velikost z katalogu, např. M",
"type": "string"
}
},
"required": [
"product",
"size",
"quantity"
],
"type": "object"
},
"type": "array"
},
"pickupPointId": {
"description": "id výdejního místa z find_pickup_points (povinné u dopravy na výdejní místo)",
"type": "string"
},
"pickupPointName": {
"description": "název výdejního místa (volitelné, doplní se samo)",
"type": "string"
},
"promoCode": {
"description": "slevový kód; neplatný kód = chyba (nikdy tiše plná cena)",
"type": "string"
},
"shippingId": {
"description": "doprava: zasilkovna (výdejní místo / Z-BOX, 89 Kč), balikovna (69 Kč), ppl-vydejni (79 Kč), dpd-vydejni (89 Kč), ppl / dpd (na adresu, 129 Kč); od 1 500 Kč zdarma; osobni (Šitbořice) jen se slevovým kódem, který ho odemyká",
"enum": [
"zasilkovna",
"balikovna",
"ppl-vydejni",
"dpd-vydejni",
"ppl",
"dpd",
"osobni"
],
"type": "string"
}
},
"required": [
"items"
],
"type": "object"
},
"name": "quote_order",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:947e5e6fa83de039c4e220f379353953a677d4bb66eae3c761cfae7f1101a9fa | sha256sum