route-mcp
Allows comparing door-to-door travel times by bicycle, motorbike, and public transport using the Google Maps Routes API, and returns weather at departure.
Provides address search and disambiguation using the French Base Adresse Nationale (IGN) geocoding service.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@route-mcp Compare bike, motorbike, and transit times from Paris to Versailles, plus weather."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
route-mcp
MCP server comparing door-to-door travel time in Île-de-France by bicycle, motorbike (estimate) and public transport, with local weather, plus a terminal chat client driven by a local LLM (Ollama).
Design decisions and their rationale: docs/TECHNICAL_REPORT.md.
Tools exposed
Tool | What it does | Metered? |
| Travel time per mode between two places, fastest mode, weather at departure | Google Routes: 1 Essentials call each for bicycle and transit, 1 Pro call for motorbike |
| Current conditions + hourly forecast (up to 48 h) | Open-Meteo (free, daily cap) |
| Disambiguate an address or place name | Free |
| Calls used / remaining per budget | Free |
Related MCP server: Weather MCP Server
Requirements
Python 3.12+
Ollama with
llama3.1:8bpulled (client only)A Google Maps Platform API key with the Routes API enabled (routes only; weather and geocoding need no key)
Setup
python3 -m venv .venv
.venv/bin/pip install -e ".[client,dev]"
cp .env.example .env # then set ROUTE_MCP_GOOGLE_MAPS_API_KEYBefore using a real key, apply the Google Cloud Console safeguards described in the report (API restriction + daily quota).
Then check the key with one real request (counted in the usage ledger):
.venv/bin/route-mcp-check-google # bicycle, Routes Essentials
.venv/bin/route-mcp-check-google --mode motorbike # also checks the Routes Pro SKUOn failure it prints Google's error reason (API not enabled, key restriction, billing...) and how to fix it.
Run
# Terminal chat (starts the MCP server itself over stdio)
.venv/bin/route-mcp-chat
# commands: /tools /usage /viewer /reset /help /quit
# trace viewer: open http://127.0.0.1:8765 while chatting
# Server alone, for any MCP host (Claude Desktop, MCP Inspector, ...)
.venv/bin/route-mcp-serverExample MCP host configuration:
{
"mcpServers": {
"route-mcp": {
"command": "/absolute/path/to/route-MCP/.venv/bin/route-mcp-server",
"env": { "ROUTE_MCP_GOOGLE_MAPS_API_KEY": "..." }
}
}
}Android app and phone API
android/: native Android app (Kotlin, Jetpack Compose). Saved places and the API token stay on the phone. Built so a home-screen widget can reuse the same data layer.route-mcp-api: the HTTP API the app calls, meant for a server (Docker + Caddy for HTTPS). Deployment guide: docs/DEPLOY_VPS.md.POST /v1/advice: comparison and rule-based choice, from coordinates sent by the phone.POST /v1/advice/{id}/explanation: two or three sentences by Claude Opus 5 (server-side refusal fallback enabled), written once per advice and capped per day in the usage ledger.GET /v1/places/search,GET /v1/usage, andGET /v1/health(the only route without a token).Every other route requires
Authorization: Bearer $ROUTE_MCP_API_TOKEN.
App: which transport now?
A local web page to save four places (home, pool, athletics track, work), get your position from the browser, and get advice on the best mode to reach one of them.
.venv/bin/pip install -e ".[app,dev]"
.venv/bin/route-mcp-app # then open http://127.0.0.1:8766Places are searched with
find_place(free) or set from your current position, and saved in~/.route-mcp/places.json(owner-only permissions).Advice calls
compare_routesthrough the MCP server over stdio, from your position to the place.The mode is chosen by fixed rules, not by the model: travel time, plus penalties for rain, strong gusts and cold on two wheels, a warm-up bonus for cycling to the track, and a penalty for a bike ride over 25 minutes to work. The rules are listed on screen with the result.
The local model (Ollama) then writes a two- or three-sentence explanation. If it is unavailable, the rule-based reasons are shown on their own.
Cost per advice: at most 2 Routes Essentials calls and 1 Routes Pro call, reused for 5 minutes.
The browser only shares your position on
localhostor HTTPS, so the page must be opened on this machine.
Trace viewer
The chat serves a local debugging page at http://127.0.0.1:8765 (standard library only, bound to
localhost). It updates live and shows, for each question:
every LLM round: latency, prompt/output tokens against the context window, thinking text (for models that emit it), the tool calls requested, and the exact prompt sent (after history trimming);
every tool call: arguments, latency, the result as fed back to the model, and errors;
the final answer, a forced answer when the tool-round limit is hit, or the exception.
The last 50 questions are kept in memory. Change the port or disable it with ROUTE_MCP_CLIENT_VIEWER_PORT
(0 = off).
Test
.venv/bin/pytest # offline: every upstream API is faked
.venv/bin/ruff check src testsConfiguration
All settings are environment variables (or .env), listed with their defaults in .env.example.
The usage ledger lives in ~/.route-mcp/usage.sqlite3: keep one per API key.
Data sources and licences
Routes: Google Maps Platform Routes API (Google terms apply).
Geocoding: Géoplateforme / Base Adresse Nationale (IGN), free service.
Weather: Open-Meteo, CC BY 4.0. The free API is for non-commercial use only.
Available Tools
4 toolscompare_routesARead-only
Compare door-to-door travel time by bicycle, motorbike and public transport (metro, RER, bus, tram) between two places in Île-de-France. Motorbike times are estimates.
Inputs: origin (required), destination (required), modes, departure_time, +1 more. Returns: notes, origin, results, destination, +3 more
find_placeARead-onlyIdempotent
List the best matching places in Île-de-France for an address or name. Use it when a place is ambiguous, before comparing routes.
Inputs: query (required). Returns: result
get_api_usageARead-onlyIdempotent
How many metered API calls are used and remaining in the current period, per budget.
Inputs: no named parameters. Returns: result
get_weatherARead-onlyIdempotent
Current weather and hourly forecast (temperature, rain, wind) for a place in Île-de-France.
Inputs: location (required), hours, start_time. Returns: place, hourly, current, timezone, +1 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: place lookup, route comparison, weather lookup, and API usage monitoring. There is no meaningful overlap between any of the tools.
All tools follow a consistent verb_noun pattern: compare_routes, get_weather, find_place, get_api_usage. The naming convention is uniform and predictable.
Four tools is a reasonable, focused scope for a routing assistance server. Each tool serves a necessary function and none feel redundant or excessive.
The core workflow is covered: find a place, compare routes, and optionally check weather. Minor gaps exist such as lack of route detail endpoints or alternative route options, but the essential use case is well supported.
Maintenance
Related MCP Connectors
Weather, air quality and nearest live sensors anywhere, each with a signed receipt. Free, no key.
Geocode, reverse-geocode, autocomplete, route and search places.
Geocoding, weather forecasts, and timezone lookups
Weather data, forecast API, climate data, historical weather, alerts, agricultural & travel weather.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnables AI-assisted travel planning with real-time weather forecasts, place discovery, customized itinerary generation based on interests and budget, and travel distance calculations between cities.-
- AlicenseAqualityCmaintenanceProvides real-time, historical, and forecasted weather data for any location worldwide using the Open-Meteo API. It includes specialized tools for agricultural growing conditions, weather alerts, and up to 16 days of forecasts across multiple transport modes.6ISC
- AlicenseNot gradedqualityDmaintenanceProvides real-time weather data, forecasts, alerts, and location comparisons via the OpenWeatherMap API.MIT
- AlicenseAqualityBmaintenanceEnables public-transport journey planning, place search, realtime departures and timetables, usable from any MCP client.9MIT