TollCalc integreren in uw eigen applicatie

TollCalc kan op drie manieren worden geïntegreerd in uw software of AI-workflows:

REST API

Volledige API-documentatie (OpenAPI 3.0) beschikbaar op:

tollcalc.eu/en/api.html

Snel starten

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

Parameters

Optionele HTTP-header:

Authenticatie

API-tokens zijn beschikbaar na registratie op app.tollcalc.eu. Zonder token zijn 10 gratis verzoeken per maand (per IP-adres) toegestaan.

Verbruik en quota opvragen

Zodra de API is geïntegreerd, kun je je verbruik en quota programmatisch opvragen – beide endpoints zijn read-only, verbruiken zelf geen quota en accepteren dezelfde bearer-token:

Optionele queryparameters: year en month (standaard: huidige maand).

# Verbruik per subaccount
curl https://app.tollcalc.eu/api/usage \
  -H "Authorization: Bearer UW_API_TOKEN"
# {"year":2026,"month":9,"total":1000,
#  "sub_accounts":[{"key":"kunde_a","count":500},{"key":"Default","count":320}]}

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

Zonder X-Subaccount-header bij een berekening worden de aanroepen aan de sleutel Default toegewezen. Bij onbeperkte abonnementen zijn limit en remaining null.

MCP – Integratie in AI-assistenten

TollCalc ondersteunt het Model Context Protocol (MCP) en kan direct worden verbonden met AI-tools zoals Claude Desktop, Cursor of een andere MCP-compatibele assistent.

Endpoint

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

Beschikbare tools

Configuratie in Claude Desktop

Voeg het volgende toe aan uw Claude Desktop-configuratie (claude_desktop_config.json):

Optie A – OAuth (aanbevolen): Alleen de URL, geen token nodig.

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

Optie B – API-sleutel (voor automatisering): Token handmatig instellen, bijv. voor server-naar-server-integraties.

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

Zonder configuratie zijn 10 gratis verzoeken per MCP-sessie (= per gesprek) beschikbaar — geen account vereist. Na 10 verzoeken opent Claude Desktop automatisch een browserlogin (OAuth 2.0). Na het inloggen geldt het quotum van het gekozen abonnement. API-sleutels voor optie B kunt u aanmaken op app.tollcalc.eu.

Detailniveaus

De tool calculate_toll ondersteunt drie detailniveaus via de parameter detail:

Antwoordvelden

Alle detailniveaus bevatten de volgende velden:

Met detail=detailed bevat countries ook segments (weg, type, km, toll_eur per segment). Met detail=full bevatten segmenten coördinaten, source_url, matched_geofence en geometrie.

Python-pakket tollcalc

Het Python-pakket tollcalc omhult de REST API voor gebruik vanuit Python-scripts of Jupyter Notebooks.

Installatie

pip install tollcalc

Gebruik

from tollcalc import calculate_toll, get_usage, get_quota

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

print(f"Totaal tol:  {result['total_toll_eur']:.2f} EUR")
print(f"Afstand:     {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} tol-km)")

Verbruik en quota vanuit Python

from tollcalc import get_usage, get_quota

usage = get_usage(token="UW_API_TOKEN")
print(usage["total"], "Calls")
for s in usage["sub_accounts"]:
    print(f"  {s['key']}: {s['count']}")

quota = get_quota(token="UW_API_TOKEN")
print(f"{quota['used']} / {quota['limit']} – resterend: {quota['remaining']}")

Pakketdocumentatie

Volledige documentatie en voorbeelden op PyPI: pypi.org/project/tollcalc

Prijzen & quota

Alle plannen en actuele prijzen: tollcalc.eu/en/#pricing

Voor integratievragen: support@tollcalc.eu