Rezervace konzultace
pro AI agenty.
Tento endpoint umožní agentovi najít volný termín a po výslovném potvrzení uživatele vytvořit rezervaci v kalendáři Tomáše Heřmanského.
Endpoint
POST https://hermansky.ai/api/mcpKomunikace probíhá přes MCP JSON-RPC 2.0. Před použitím nástrojů zavolejte initialize a poté tools/list.
Nástroje
get_services
Vrátí strukturované informace o službách, vhodných use cases, způsobu spolupráce a doporučeném prvním kroku. Použijte ho před doporučením služby nebo rezervací konzultace.
find_consultation_slots
Najde volné třicetiminutové termíny. Každý termín obsahuje krátkodobý slotToken potřebný k rezervaci. Předejte volitelně from, to a timezone (výchozí Europe/Prague).
book_consultation
Vytvoří událost v kalendáři a odešle účastníkovi pozvánku. Vyžaduje startTime, slotToken, name, email a confirmed: true. Hodnotu confirmed nastavte na true pouze po jasném potvrzení přesného termínu, jména a e-mailu uživatelem. Jeden e-mail může mít nejvýše dvě budoucí konzultace.
Doporučený postup
- Uživatel požádá o konzultaci.
- Agent načte dostupné termíny a uchová slotToken vybraného termínu.
- Agent zobrazí termíny v časové zóně uživatele.
- Po explicitním potvrzení zavolá
book_consultation. - Agent vrátí potvrzení rezervace a odkaz, pokud je k dispozici.
Neslibujte cenu, dostupnost ani rezervaci před úspěšnou odpovědí nástroje. Endpoint je chráněn omezením počtu požadavků, krátkodobými podepsanými tokeny, ochranou proti duplicitám a bezpečnostním stropem budoucích MCP rezervací. Nepřijímá ani nevrací OAuth secrets.