Tolls MCP Server

Model Context Protocol server for the TRANSCEND Tolls Calculator API.

Calculate toll costs, list operators, and get tariff data across Spain, Portugal, and France — all from your LLM assistant.

Tools

Tool	Description
calculate_toll	Calculate toll costs between two coordinates for a vehicle type
list_operators	List all toll operators with their highways and countries
get_tariffs	Get toll tariffs for a specific operator and vehicle type
health_check	Check if the API service is healthy

Quick Start

Requirements

• Python 3.10+
• httpx

Install & Run

pip install httpx
python server.py

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "tolls": {
      "command": "python",
      "args": ["/path/to/server.py"],
      "env": {
        "TOLLS_API_URL": "https://tolls.transcend.cargoffer.com"
      }
    }
  }
}

Environment Variables

Variable	Default	Description
TOLLS_API_URL	https://tolls.transcend.cargoffer.com	API base URL
TOLLS_API_KEY	""	Optional API key for authenticated endpoints

API

The MCP server wraps the TRANSCEND Tolls Calculator REST API.

calculate_toll

Calculate toll costs between two coordinates.

Parameters:

• origin_lat, origin_lng — Origin coordinates
• destination_lat, destination_lng — Destination coordinates
• vehicle_type — light, truck, bus, or motorcycle (default: truck)

Example response:

{
  "totalCost": 14.64,
  "currency": "EUR",
  "segments": [
    {
      "highway": "C-16",
      "operator": "autema",
      "cost": 14.64,
      "distance_km": 45.2
    }
  ]
}

list_operators

List toll operators. Optional country filter (ES, PT, FR).

get_tariffs

Get detailed tariffs for an operator. Parameters:

• operator — e.g. autema, atlandes, brisa
• vehicle_type — Optional filter

Deployment

Docker

docker build -t tolls-mcp .
docker run -e TOLLS_API_URL=https://tolls.transcend.cargoffer.com tolls-mcp

Coolify

1. Create a new service in Coolify
2. Set the Docker image or use the Dockerfile
3. Set env vars in the Coolify dashboard
4. Domain: mcp.tolls.cargoffer.com

License

MIT