TollCalc API és MCP-integráció

A TollCalc REST API és MCP (Model Context Protocol) szerver segítségével a mautszámítás közvetlenül integrálható saját rendszerekbe.

REST API

• POST /api/calculate – mautszámítás útvonalra (origin, destination, via, vehicle)
• GET /api/rules – aktuális mautszabályok országonként
• Opszonális paraméter: plannedTripStart (dátum vagy datetime) – a megadott időpontban érvényes szabálybázis használata
• Opcionális fejléc: X-Subaccount (használat-hozzárendelési címke, pl. ügyfélcég; max. 64 karakter, engedélyezett A-Z a-z 0-9 _ : -; érvénytelen esetén → HTTP 400)

MCP-szerver

Az MCP-n keresztül az AI-asszisztensek közvetlenül hívhatják a calculate_toll eszközt – a járműadatokkal, kiindulási és célponttal. A részletes válasz tartalmazza az országonkénti bontást és egy info-URL-t a térképes megjelenítéshez.

Hitelesítés

• API-kulcs: Authorization: Bearer <token> fejlécben
• Az anonim hozzáférés havi 10 számításra korlátozott
• Használat: GET /api/usage – a havi sikeres számítások X-Subaccount szerinti bontásban
• Hátralévő kvóta: GET /api/quota – felhasznált, havi limit és hátralévő (opcionális year/month)
• A teljes dokumentáció a tollcalc.eu/en/api.html oldalon

→ API-dokumentáció megnyitása