https://github.com/cargoffer/transcend-mcp-server
MCP Server for TRANSCEND Route Optimization API. Model Context Protocol tools for route optimization, toll costs, weather, POIs, traffic and fuel stations. Compatible with Claude Desktop, Cursor and any LLM supporting MCP.
https://github.com/cargoffer/transcend-mcp-server
api-integration claude-desktop erp-integration fleet-management logistics-api logistics-software mcp-server mcp-tools model-context-protocol openapi poi-api python route-optimization route-planning supply-chain tms traffic-api transportation trucking weather-api
Last synced: about 2 hours ago
JSON representation
MCP Server for TRANSCEND Route Optimization API. Model Context Protocol tools for route optimization, toll costs, weather, POIs, traffic and fuel stations. Compatible with Claude Desktop, Cursor and any LLM supporting MCP.
- Host: GitHub
- URL: https://github.com/cargoffer/transcend-mcp-server
- Owner: cargoffer
- Created: 2026-05-19T08:21:51.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-19T08:36:41.000Z (about 2 months ago)
- Last Synced: 2026-05-19T12:30:42.838Z (about 2 months ago)
- Topics: api-integration, claude-desktop, erp-integration, fleet-management, logistics-api, logistics-software, mcp-server, mcp-tools, model-context-protocol, openapi, poi-api, python, route-optimization, route-planning, supply-chain, tms, traffic-api, transportation, trucking, weather-api
- Language: Python
- Homepage: https://transcend.cargoffer.com
- Size: 23.4 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - **cargoffer/transcend-mcp-server** - AI-powered route optimization MCP server for heavy vehicles. Calculate truck routes, predict traffic with LSTM neural networks, compute tolls, fuel costs and CO2 emissions. Find truck stops and check weather along European routes. `http` `ai` `git` `github` (📦 Other)
README
# Operational MCP layer for European road transport intelligence
[](https://opensource.org/licenses/MIT)
[](https://modelcontextprotocol.io)
[](https://python.org)
[](https://github.com/cargoffer/transcend-mcp-server/releases)
[](https://github.com/cargoffer/transcend-mcp-server)
**A route optimization MCP server** that connects AI agents (Claude Desktop, Cline, Continue, Cursor, etc.) to the TRANSCEND logistics intelligence platform — giving LLMs real-time access to truck route optimization, toll costs, weather, parking, traffic blackspots, and fuel station pricing across Spain and Europe.
> **What problem does it solve?** Truck logistics operators waste hours switching between Google Maps (not truck-aware), toll websites, weather apps, and fuel price spreadsheets. This MCP server consolidates 6 real-time logistics data sources into a single AI-callable interface so agents can plan routes, estimate costs, and assess risks in one step.
>
> **What makes it different?** Unlike generic mapping APIs, TRANSCEND is purpose-built for European **truck logistics API** needs — it respects ADR (dangerous goods) restrictions, truck height/width/weight limits, provides per-segment toll breakdowns with fuel and CO₂ costs, identifies dangerous blackspot zones, and locates truck-specific parking. It is the only unified MCP interface for European road logistics infrastructure.
>
> **What integration does it enable?** Any MCP-compatible client can invoke 12 logistics intelligence tools covering route optimization, toll cost estimation, weather conditions, POI parking, traffic blackspot analysis, and fuel station pricing — all from a single conversation with an LLM.
>
> **What does "easy integration" mean concretely?** `pip install` the package, set `TRANSCEND_API_KEY`, and add one JSON config block to Claude Desktop. No microservice orchestration, no multi-API key management, no custom middleware. Your AI assistant gains instant access to professional European **logistics document automation** and route intelligence.
---
## Why this MCP exists
European truck route planning is fragmented. Google Maps doesn't know truck height restrictions. Toll calculators are per-country. Weather alerts come from a third source. Fuel prices change hourly. Dispatchers manually juggle 5+ tabs to answer a single question like "what's the safest and cheapest route from Madrid to Frankfurt for a 4m-high refrigerated truck?"
This MCP server aggregates six TRANSCEND API microservices (Route, Tolls, Weather, POI, Traffic, Stations) behind a single MCP interface — making **European road transport** data accessible to AI agents through natural language. It transforms the agent from a chat interface into an operational logistics copilot.
---
## MCP Capabilities
- **12 MCP tools** across 6 logistics modules — organized by domain, not buried in code
- **Truck-aware route optimization** with ADR class restrictions, vehicle dimensions, and weight limits
- **Full cost breakdown** — tolls + fuel consumption + maintenance + CO₂ emissions per route
- **Real-time weather** — current conditions, multi-day forecasts, and active weather alerts along a corridor
- **Truck parking POI search** — by coordinates, zip code, or province (with capacity and amenities)
- **Traffic blackspot identification** — dangerous road zones along a planned route
- **Fuel station finder** — nearby stations, filtered search, and best-price ranking
- **Environment-aware configuration** — separate URLs for production vs. dev/release environments
- **HTTP/SSE and stdio transports** — works with all MCP clients out of the box
- **Pydantic-validated** inputs and outputs — Python 3.10+, httpx async client
---
## Tools
| Module | Tool | Description |
|--------|------|-------------|
| 🗺️ **Route** | `calculate_route` | Optimized truck route with ADR, height, width, weight constraints |
| 💰 **Tolls** | `calculate_route_costs` | Fuel + tolls + maintenance + CO₂ cost estimation |
| 🌤️ **Weather** | `get_current_weather` | Real-time weather at a location |
| | `get_weather_forecast` | Forecast for a date range |
| | `get_weather_alerts` | Active weather warnings |
| 🅿️ **POI** | `find_parking_by_location` | Truck parking near coordinates |
| | `find_parking_by_zipcode` | Parking by postal code |
| | `find_parking_by_province` | Parking by province |
| 🛑 **Traffic** | `get_blackspots_path` | Dangerous zones along a route |
| ⛽ **Stations** | `find_stations_nearby` | Fuel stations near coordinates |
| | `search_stations` | Filter stations by fuel type, text search |
| | `get_station_best_prices` | Best fuel prices near a location |
---
## Directory structure
```
transcend-mcp-server/
├── pyproject.toml # Python 3.10+, dependencies: mcp, httpx, pydantic
├── src/transcend_mcp/
│ ├── server.py # FastMCP server bootstrap (stdio / HTTP/SSE)
│ ├── client.py # Multi-service HTTP client (6 backend APIs)
│ ├── config.py # Environment-aware URL resolution (prod / release-dev)
│ ├── tools.py # 12 MCP tool definitions with pydantic schemas
│ ├── __init__.py # Package init
│ └── __main__.py # Entry point for `python -m transcend_mcp`
└── tests/
└── test_client.py # Integration tests for client.py
```
---
---
## Authentication
To use this MCP server, you need an API key from the TRANSCEND platform.
**Register:** https://transcend.cargoffer.com
Create an account and get your API key from your profile settings. Then configure:
```bash
export TRANSCEND_API_KEY="your-api-key"
```
Or in your MCP client config:
```json
{
"mcpServers": {
"transcend": {
"command": "...",
"env": {
"TRANSCEND_API_KEY": "your-api-key-from-transcend"
}
}
}
}
```
## Quick Start
```bash
git clone https://github.com/cargoffer/transcend-mcp-server.git
cd transcend-mcp-server
pip install -e .
export TRANSCEND_API_KEY="your-api-key"
python -m transcend_mcp
```
By default runs on **stdio** (MCP transport). Set `MCP_HOST` / `MCP_PORT` for HTTP/SSE mode.
---
## Installation
### Claude Desktop
Add to `claude_desktop_config.json`:
```json
{
"mcpServers": {
"transcend": {
"command": "python",
"args": ["-m", "transcend_mcp"],
"env": {
"TRANSCEND_API_KEY": "your-api-key",
"TRANSCEND_ENV": "production"
}
}
}
}
```
### Cursor
**Cursor Settings → Features → MCP Servers → Add New**:
```
Name: transcend
Type: command
Command: python -m transcend_mcp
Env: TRANSCEND_API_KEY=your-api-key, TRANSCEND_ENV=production
```
### Direct HTTP / SSE
```bash
export MCP_HOST=0.0.0.0
export MCP_PORT=8100
python -m transcend_mcp
# Then connect SSE at http://localhost:8100/sse
```
---
## MCP protocol in action
**Calculate an optimized truck route:**
```bash
# With stdio transport, use any MCP client. For HTTP/SSE mode:
# First, connect to SSE endpoint, then send JSON-RPC messages
# Example using the JSON-RPC format over SSE (after establishing connection):
{
"jsonrpc": "2.0",
"id": 1,
"method": "calculate_route",
"params": {
"origin": "Vigo, Spain",
"destination": "Barcelona, Spain",
"dimensions": {
"height": 4.0,
"width": 2.55,
"weight": 40000,
"adr_class": null
}
}
}
```
**Get route costs with real toll data:**
```json
{
"jsonrpc": "2.0",
"id": 2,
"method": "calculate_route_costs",
"params": {
"route_id": "route_abc_123",
"fuel_consumption": 35,
"fuel_type": "diesel",
"include_co2": true
}
}
```
**Find truck parking along the route:**
```json
{
"jsonrpc": "2.0",
"id": 3,
"method": "find_parking_by_location",
"params": {
"latitude": 41.6488,
"longitude": -0.8891,
"radius_km": 10
}
}
```
---
## Example Prompts for AI Agents
> "Calculate an optimized truck route from Vigo to Barcelona. The truck is 4m high, 2.55m wide, 40 tons. Include blackspot warnings."
> "What's the total cost of a 15-ton load from Madrid to Valencia with average fuel consumption of 35L/100km using diesel?"
> "Find truck parking near Plaza España in Zaragoza."
> "What fuel stations are near the A-2 highway at Guadalajara? Show me the best prices."
> "Are there any dangerous zones on the route from Seville to Málaga?"
> "What's the weather forecast along the A-3 from Madrid to Valencia for tomorrow? Any alerts?"
---
## Configuration
### Environment Variables
| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `TRANSCEND_API_KEY` | ✔ | — | Your TRANSCEND API key |
| `TRANSCEND_ENV` | | `production` | `production` or `release-dev` |
| `LOG_LEVEL` | | `INFO` | Logging verbosity |
| `MCP_HOST` | | `localhost` | HTTP/SSE bind address |
| `MCP_PORT` | | `8100` | HTTP/SSE port |
### Production Microservice URLs
| Module | Prod URL |
|--------|----------|
| Tolls | `https://back.transcend.cargoffer.com/transcend/tolls` |
| POI | `https://back.transcend.cargoffer.com/transcend/poi` |
| Stations | `https://back.transcend.cargoffer.com/transcend/stations` |
| Weather | `https://back.transcend.cargoffer.com/transcend/weather` |
| Traffic | `https://back.transcend.cargoffer.com/transcend/traffic` |
---
## Development
```bash
pip install -e ".[dev]"
pytest
ruff check src/
ruff format src/
```
---
## Semantic tags
`route optimization MCP` `truck logistics API` `MCP server` `Model Context Protocol` `European road transport` `logistics document automation` `TRANSCEND` `truck routing` `toll calculator` `fuel prices` `truck parking` `weather alerts` `traffic blackspots` `ADR restrictions` `CO2 emissions` `AI agents` `LLM tools` `supply chain` `Spain logistics` `Cargoffer` `easy MCP integration`
---
## License
MIT — see [LICENSE](LICENSE) file for details.
---
## Links
- **Repository:** [github.com/cargoffer/transcend-mcp-server](https://github.com/cargoffer/transcend-mcp-server)
- **Issues:** [github.com/cargoffer/transcend-mcp-server/issues](https://github.com/cargoffer/transcend-mcp-server/issues)
- **MCP Protocol:** [modelcontextprotocol.io](https://modelcontextprotocol.io)