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
| Co | Adresa |
|---|---|
| REST API sazeb a výpočtů | https://app.jizdaro.cz/api/v1 |
| OpenAPI 3.1 | app.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 karta | https://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žby | app.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=truepro 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ástroj | Co dělá | Přihlášení |
|---|---|---|
sazby_cestovnich_nahrad | Sazby a ceny paliv k datu | ne |
vypocet_nahrady | Náhrada za jednu jízdu | ne |
pausal_nebo_nahrady | Roční srovnání paušálu s náhradami | ne |
seznam_vozidel | Vaše vozidla (knihy jízd) | ano, jizdy:cteni |
seznam_jizd | Jízdy za měsíc a vozidlo | ano, jizdy:cteni |
souhrn_mesice | Km, náhrady, paušál a Kontrola Jizdara za měsíc | ano, jizdy:cteni |
zapsat_jizdu | Zapíš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.
| Rozsah | Dovoluje |
|---|---|
jizdy:cteni | číst vozidla, jízdy a měsíční souhrny |
jizdy:zapis | zapisovat 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-RPCmessage/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 adresyindex.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.