Pro vývojáře a AI agenty

Jizdaro pro vývojáře a AI agenty

Veřejné API se sazbami cestovních náhrad, MCP server pro AI asistenty a popis všeho, co agenti mohou. Jen to, co opravdu funguje.

Stručně:

  • Sazby a výpočty podle vyhlášek MPSV jsou veřejné, bez přihlášení a bez osobních údajů: REST API, MCP nástroje i A2A.
  • Kniha jízd přes MCP po přihlášení: čtení jízd a měsíčních souhrnů a zápis nových jízd. Nic se přes MCP nemaže ani neupravuje.
  • Přístup agenta vždy schvaluje uživatel a v Jizdaru ho kdykoli odebere (Účet → Připojené aplikace).

Adresy

CoAdresa
REST API sazeb a výpočtůhttps://app.jizdaro.cz/api/v1
OpenAPI 3.1app.jizdaro.cz/openapi.json
MCP server (Streamable HTTP)https://app.jizdaro.cz/mcp
MCP Server Card/.well-known/mcp/server-card.json
A2A agent (JSON-RPC) a jeho kartahttps://app.jizdaro.cz/a2a, /.well-known/agent-card.json
API katalog (RFC 9727)/.well-known/api-catalog
Přihlášení agentůauth.md, metadata autorizačního serveru, metadata chráněného zdroje
Dovednosti agentů/.well-known/agent-skills/index.json
Stav službyapp.jizdaro.cz/api/health

Veřejné API sazeb a výpočtů

Jen čtení, bez přihlášení, povolené CORS. Sazby jsou ze stejného zdroje jako aplikace a kalkulačka (vyhlášky MPSV, ověřeno 2. 10. 2026), výpočty stejné jako v aplikaci. Výsledky jsou orientační.

  • GET /api/v1/sazby?datum=RRRR-MM-DD: základní náhrada, ceny nafty, benzinu 95 a 98 a elektřiny platné k datu, číslo vyhlášky a zdroj.
  • GET /api/v1/nahrada?km=&spotreba=&palivo=&datum=: náhrada za služební jízdu (palivo: nafta, benzin, benzin98, elektrina).
  • GET /api/v1/pausal-nebo-nahrady?km_mesicne=&palivo=&spotreba=&rok=: roční srovnání paušálu s náhradami jako v kalkulačce (nepovinné soukroma=true pro paušál 4 000 Kč).
curl "https://app.jizdaro.cz/api/v1/nahrada?km=100&spotreba=6&palivo=nafta&datum=2026-11-13"

{
  "datum": "2026-11-13",
  "km": 100,
  "palivo": "nafta",
  "spotreba_na_100_km": 6,
  "zakladni_sazba_kc_za_km": 5.9,
  "cena_paliva_kc": 44.5,
  "zakladni_nahrada_kc": 590,
  "nahrada_za_palivo_kc": 267,
  "celkem_kc": 857,
  "…": "…"
}

MCP server pro AI asistenty

Adresa serveru: https://app.jizdaro.cz/mcp (Model Context Protocol, Streamable HTTP). Dá se přidat jako vlastní konektor v Claude, ChatGPT i dalších klientech, které MCP podporují; názvy menu se podle verze aplikace liší, obvykle je to Nastavení → Konektory → Přidat vlastní konektor a vložení adresy výše. Klient se sám zaregistruje (dynamická registrace klienta) a otevře přihlášení do Jizdara se souhlasem.

NástrojCo děláPřihlášení
sazby_cestovnich_nahradSazby a ceny paliv k datune
vypocet_nahradyNáhrada za jednu jízdune
pausal_nebo_nahradyRoční srovnání paušálu s náhradamine
seznam_vozidelVaše vozidla (knihy jízd)ano, jizdy:cteni
seznam_jizdJízdy za měsíc a vozidloano, jizdy:cteni
souhrn_mesiceKm, náhrady, paušál a Kontrola Jizdara za měsícano, jizdy:cteni
zapsat_jizduZapíše novou jízdu (datum, odkud, kam, účel, km nebo návrh km z předchozí jízdy po stejné trase)ano, jizdy:zapis

Zápis má stejná pravidla jako v aplikaci: kontrola údajů, limity tarifu (Free: 30 jízd měsíčně), zápis do historie změn, jízda je označená zdrojem „napojení“. Do uzavřeného měsíce se přes MCP nezapisuje, stejnou jízdu server podruhé nezapíše. Jízdy se přes MCP nemažou ani neupravují. Jako zdroj je k dispozici i tabulka aktuálních sazeb (jizdaro://sazby/aktualni).

curl -X POST https://app.jizdaro.cz/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"vypocet_nahrady","arguments":{"km":100,"spotreba":6,"palivo":"nafta"}}}'

Přihlášení a rozsahy oprávnění

OAuth 2.1 s povinným PKCE (S256) a dynamickou registrací klienta; tokeny jsou krátké (access token 1 hodina, refresh token 30 dní s rotací). Uživatel se přihlásí svým účtem a na obrazovce souhlasu klikne Povolit. Podrobně v auth.md.

RozsahDovoluje
jizdy:cteničíst vozidla, jízdy a měsíční souhrny
jizdy:zapiszapisovat nové jízdy (nic nemaže ani neupravuje)

Přístup lze kdykoli odebrat v Jizdaru: Účet → Připojené aplikace.

Limity

  • Veřejné API a A2A: 60 požadavků za minutu na IP adresu. MCP: 120 za minutu. Zápisy jízd: 60 za minutu na účet.
  • Tarif účtu platí i přes MCP (například Free má 30 jízd za měsíc).
  • Sazby existují jen pro období, která vyhlásilo MPSV; pro jiné datum API odpoví chybou 404.

A2A, dovednosti a Markdown

  • A2A: https://app.jizdaro.cz/a2a (JSON-RPC message/send) umí stejné tři výpočty. Vstup je strukturovaný (datová část se jménem dovednosti); na volný text odpoví, jaké vstupy potřebuje. Bez jazykového modelu, výpočty jsou deterministické.
  • Dovednosti agentů (index): jak počítat cestovní náhrady a jak připojit Jizdaro přes MCP.
  • Markdown: každou stránku tohoto webu vrátíme jako Markdown, když pošlete Accept: text/markdown, nebo přidáte na konec adresy index.md.
  • WebMCP: stránky webu nabízejí prohlížečům s podporou WebMCP nástroje pro výpočet náhrady, srovnání paušálu, sazby a hledání v poradně.

Kontakt

Dotazy, nápady a chyby: podpora@jizdaro.cz. Bezpečnostní problémy hlaste stejně.

Vyzkoušejte to na dnešní jízdě.

Zdarma pro 1 auto a 30 jízd měsíčně, bez platební karty. Ukázku si prohlédnete i bez registrace.