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

Authentifizierung

API-Tokens erhalten Sie nach der Registrierung unter app.tollcalc.eu. Ohne Token sind 10 kostenlose Anfragen pro Session möglich.

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 TollCalc

client = TollCalc(api_key="IHR_API_TOKEN")

result = client.calculate(
    origin="Munich, Germany",
    destination="Vienna, Austria",
    weight=40,
    axles=5,
    emission_class="euro6",
    co2_class="class_1",
)

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)")

Koordinaten als Eingabe

result = client.calculate(
    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.