Integrar o TollCalc nas suas próprias aplicações

O TollCalc pode ser integrado no seu próprio software ou fluxos de trabalho de IA de três formas:

REST-API

A documentação completa da API (OpenAPI 3.0) encontra-se em:

tollcalc.eu/en/api.html

Início rápido

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

Parâmetros

Autenticação

Os tokens de API são obtidos após o registo em app.tollcalc.eu. Sem token, são possíveis 10 pedidos gratuitos por sessão.

MCP – Integração em assistentes de IA

O TollCalc suporta o Model Context Protocol (MCP) e pode ser integrado diretamente em ferramentas de IA como Claude Desktop, Cursor ou outros assistentes compatíveis com MCP.

Endpoint

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

Ferramentas disponíveis

Configuração no Claude Desktop

Adicione à sua configuração do Claude Desktop (claude_desktop_config.json):

Opção A – OAuth (recomendada): basta indicar o URL, sem token.

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

Opção B – Chave de API (para automação): guardar o token manualmente, ex.: para integrações servidor-a-servidor.

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

Sem configuração, estão disponíveis 10 pedidos gratuitos por sessão MCP (= por conversa) – sem necessidade de conta. Após 10 pedidos, o Claude Desktop abre automaticamente um login no navegador (OAuth 2.0). Após o login, aplica-se a quota contratada. Os tokens de API para a Opção B são obtidos em app.tollcalc.eu.

Exemplo de chamada via MCP

Após a configuração, pode perguntar diretamente ao assistente:

„Quanto custa a portagem para um camião de 40 toneladas de Munique para Viena?"

O assistente chama a ferramenta calculate_toll e devolve uma resposta estruturada.

Níveis de detalhe

A ferramenta calculate_toll suporta três níveis de detalhe através do parâmetro detail:

Campos de resposta

Todos os níveis de detalhe contêm os seguintes campos:

Com detail=detailed, countries contém adicionalmente segments (segmentos com road, type, km, toll_eur). Com detail=full, acrescem coordenadas, source_url, matched_geofence e geometria.

Server Card

A descrição MCP (Server Card) está disponível em:

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

Pacote Python tollcalc

O pacote Python tollcalc encapsula a REST-API e permite a utilização a partir de scripts Python ou Jupyter Notebooks.

Instalação

pip install tollcalc

Utilização

from tollcalc import TollCalc

client = TollCalc(api_key="O_SEU_API_TOKEN")

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

print(f"Portagem total: {result.total_toll_eur:.2f} EUR")
print(f"Distância:      {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} km portajados)")

Coordenadas como entrada

result = client.calculate(
    origin="48.1374;11.5755",    # Munique (lat;lon)
    destination="48.2082;16.3738",  # Viena
    weight=40,
    axles=5,
)

Documentação do pacote

Documentação completa e mais exemplos no PyPI: pypi.org/project/tollcalc

Preços e quotas

Todas as tarifas e preços atuais: tollcalc.eu/de/#pricing

Para questões sobre a integração, contacte support@tollcalc.eu.