# Altman

> Klenotnictví Altman — hodinky, šperky a módní doplňky značkových výrobců. Katalog v češtině, ceny v CZK.

Tenhle e-shop provozuje MCP (Model Context Protocol) server. Pokud jste AI agent,
používejte ho — dostanete strukturovaná data rychleji a spolehlivěji než parsováním
HTML, které se navíc může kdykoliv změnit.

## MCP

- [MCP endpoint](https://altman-new-test.nahled-webu2.cz/mcp): Streamable HTTP, JSON-RPC 2.0, pouze POST.
- [Manifest](https://altman-new-test.nahled-webu2.cz/.well-known/mcp.json): adresa endpointu a podporované verze protokolu.

Podporované revize protokolu: 2025-06-18 (initialize + Mcp-Session-Id) a 2026-07-28
(bezstavová). Server éru pozná sám podle požadavku. Autentizace není potřeba.

## Dostupné nástroje

- `get_store_info` — Vrátí základní informace o e-shopu — název, měnu, jazyk katalogu a jeho rozsah (počet kategorií, počet aktivních a aktuálně dostupných produktů). Doporučeno zavolat jako první, než začnete používat ostatní nástroje — ať víte, v jaké měně jsou ceny a jak velký katalog prohledáváte.
- `search_products` — Vyhledá produkty v katalogu podle textového dotazu, značky a ceny — hledá v názvu, popisu, kódu, EAN, značce i kolekci. Vrací cenu včetně akční, stav dostupnosti, odkaz na produkt a obrázek. Hledá stejně jako vyhledávání na webu, takže vrací totéž, co uvidí zákazník. Pro dotaz na konkrétní produkt použijte get_product_detail. DŮLEŽITÉ: do "query" patří jen klíčová slova, ne celá otázka zákazníka. Slova se kombinují přes AND a hledají se jako podřetězec, takže každé slovo navíc výsledek zužuje a jediné slovo, které se v katalogu nevyskytuje, srazí výsledek na nulu — „hodinky Zenith do 100000 Kč" nenajde nic, „Zenith" najde vše. Rozpočet, značku ani dostupnost proto nepiště do "query", ale do parametrů priceMin, priceMax, brand a onlyAvailable; na „nejlevnější" a „nejdražší" použijte sort.
- `get_product_detail` — Vrátí detail jednoho produktu — popis, cenu včetně akční, stav dostupnosti, parametry, obrázky a varianty. Produkt se zadává buď ID z výsledků search_products, nebo adresou produktu (stačí i celé URL z webu). Zadejte právě jedno z toho.
- `check_stock` — Zjistí aktuální dostupnost až 20 produktů najednou — stav (skladem u nás, skladem u dodavatele, výroba na zakázku, na dotaz, není skladem), jestli zboží jde koupit a orientační dodací lhůtu ve dnech. Počty kusů se nevracejí. ID produktů získáte ze search_products nebo get_product_detail.

Všechny nástroje jsou pouze pro čtení. Objednávku přes MCP založit nelze.