TollCalc in eigene Anwendungen integrieren

TollCalc lässt sich auf drei Wegen in eigene Software oder KI-Workflows einbinden:

REST-API

Die vollständige API-Dokumentation (OpenAPI 3.0) finden Sie unter:

tollcalc.eu/en/api.html

Schnellstart

curl -X POST https://app.tollcalc.eu/api/calculate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  -d '{
    "origin": "Munich, Germany",
    "destination": "Vienna, Austria",
    "vehicle": {
      "weight": 40,
      "axles": 5,
      "emission_class": "euro6",
      "co2_class": "class_1"
    }
  }'

Parameter

Optionaler HTTP-Header:

Authentifizierung

API-Tokens erhalten Sie nach der Registrierung unter app.tollcalc.eu. Ohne Token sind 10 kostenlose Anfragen pro Monat (pro IP-Adresse) möglich.

Nutzung & Quota abrufen

Nach der API-Anbindung können Sie Ihren Verbrauch und Ihr Kontingent programmatisch abrufen – beide Endpunkte sind read-only, verbrauchen selbst kein Kontingent und akzeptieren denselben Bearer-Token:

Optionaler Query-Parameter: year und month (Standard: aktueller Monat).

# Nutzung pro Sub-Account
curl https://app.tollcalc.eu/api/usage \
  -H "Authorization: Bearer IHR_API_TOKEN"
# {"year":2026,"month":9,"total":1000,
#  "sub_accounts":[{"key":"kunde_a","count":500},{"key":"Default","count":320}]}

# Verbleibendes Kontingent
curl https://app.tollcalc.eu/api/quota \
  -H "Authorization: Bearer IHR_API_TOKEN"
# {"year":2026,"month":9,"plan":"api","used":123,"limit":5000,"remaining":4877}

Ohne X-Subaccount-Header bei der Berechnung werden die Calls dem Schlüssel Default zugeordnet. Bei unbegrenzten Tarifen sind limit und remaining null. Die vollständige Spezifikation steht in der OpenAPI-Referenz.

MCP – Integration in KI-Assistenten

TollCalc unterstützt das Model Context Protocol (MCP) und kann direkt in KI-Tools wie Claude Desktop, Cursor oder andere MCP-kompatible Assistenten eingebunden werden.

Endpoint

POST https://app.tollcalc.eu/mcp

Verfügbare Tools

Konfiguration in Claude Desktop

Fügen Sie folgendes in Ihre Claude-Desktop-Konfiguration (claude_desktop_config.json) ein:

Option A – OAuth (empfohlen): Nur die URL angeben, kein Token nötig.

{
  "mcpServers": {
    "tollcalc": {
      "url": "https://app.tollcalc.eu/mcp"
    }
  }
}

Option B – API-Key (für Automatisierung): Token manuell hinterlegen, z. B. für Server-zu-Server-Integrationen.

{
  "mcpServers": {
    "tollcalc": {
      "url": "https://app.tollcalc.eu/mcp",
      "headers": {
        "Authorization": "Bearer IHR_API_TOKEN"
      }
    }
  }
}

Ohne Konfiguration stehen 10 kostenlose Anfragen pro MCP-Sitzung (= pro Gespräch) zur Verfügung – kein Account nötig. Nach 10 Anfragen öffnet Claude Desktop automatisch einen Browser-Login (OAuth 2.0). Nach der Anmeldung gilt das gebuchte Kontingent. API-Tokens für Option B erhalten Sie unter app.tollcalc.eu.

Beispielaufruf über MCP

Nach der Einrichtung können Sie den Assistenten direkt auf Deutsch befragen:

„Was kostet die Maut für einen 40-Tonner von München nach Wien?"

Der Assistent ruft das Tool calculate_toll auf und gibt eine strukturierte Antwort zurück.

Detailstufen

Das Tool calculate_toll unterstützt drei Detailstufen über den Parameter detail:

Antwortfelder

Alle Detailstufen enthalten folgende Felder:

Mit detail=detailed enthält countries zusätzlich segments (Abschnitte mit road, type, km, toll_eur). Mit detail=full kommen Koordinaten, source_url, matched_geofence und Geometrie hinzu.

Server Card

Die MCP-Beschreibung (Server Card) ist abrufbar unter:

GET https://app.tollcalc.eu/.well-known/mcp-server

Python-Paket tollcalc

Das Python-Paket tollcalc wraps die REST-API und ermöglicht die Nutzung aus Python-Skripten oder Jupyter Notebooks.

Installation

pip install tollcalc

Verwendung

from tollcalc import calculate_toll

result = calculate_toll(
    "Munich, Germany",
    "Vienna, Austria",
    weight=40,
    axles=5,
    emission_class="euro6",
    co2_class="class_1",
    token="IHR_API_TOKEN",
)

print(f"Gesamtmaut: {result['total_toll_eur']:.2f} EUR")
print(f"Strecke:    {result['total_distance_km']:.1f} km")

for country in result["countries"]:
    print(f"  {country['country_name']}: {country['toll_eur']:.2f} EUR ({country['toll_km']:.0f} Maut-km)")

Nutzung & Quota aus Python

from tollcalc import get_usage, get_quota

# Optional: Verbrauch pro Sub-Account (Default: aktueller Monat)
usage = get_usage(token="IHR_API_TOKEN")
print(usage["total"], "Calls")
for s in usage["sub_accounts"]:
    print(f"  {s['key']}: {s['count']}")

# Verbleibendes Monatskontingent
quota = get_quota(token="IHR_API_TOKEN")
print(f"{quota['used']} / {quota['limit']} – verbleibend: {quota['remaining']}")

Koordinaten als Eingabe

result = calculate_toll(
    origin="48.1374;11.5755",    # München (lat;lon)
    destination="48.2082;16.3738",  # Wien
    weight=40,
    axles=5,
)

Paket-Dokumentation

Vollständige Dokumentation und weitere Beispiele finden Sie auf PyPI: pypi.org/project/tollcalc

Preise & Kontingente

Alle Tarife und aktuelle Preise: tollcalc.eu/de/#pricing

Bei Fragen zur Integration wenden Sie sich an support@tollcalc.eu.