APP RACES BIKEPACKING STORIES ORGANIZERS UPGRADE DOWNLOAD APP
OUT-OF-BAND TELEMETRY SCHEMA

THE GRAVALIST
DEVELOPER PORTAL

Standard mobile operating systems aggressively restrict background threads, throttling live tracking and sensor updates on rugged routes. Gravalist bridges this gap by exposing a dedicated standalone REST API and JSON-standard Model Context Protocol (MCP) server. Feed clean terrain layers and predictive rain/wind pacing parameters directly to your custom head-unit widgets or automated LLM agents.

EXPLORE MCP TOOLS LAUNCH PLAYGROUND
terminal

BUILT FOR HACKERS & CYCLISTS

Getting started is completely free. Expose gravel metrics to your self-hosted AI companions out-of-the-box.

PUBLIC_SANDBOX_KEY: gravalist_dev_key_2026
LLM COMPANION INTEGRATION

THE TWO CORE MCP TOOLS

Our Model Context Protocol manifest defines the standard structures used by leading generative systems (e.g. Cursor, Gemini, Claude Desktop) to parse telemetry parameters on demand.

MCP TOOL route

get_gravel_routes

Query high-fidelity details of curated, unsupported expeditions across major geographic hotspots. Resolves coordinates, distance gradients, elevation vectors, and primary surface metrics.

INPUT SCHEMA:

{ "limit": "number (default: 20, max: 50)" }

RETURN VALUE:

[ { "id": "ceres-500-route", "name": "Ceres Karoo Base Loop", "distance_km": 508.4 } ]
MCP TOOL filter_drama

get_weather_pacing_model

Retrieves predictive wind speed, rain density, and segment-by-segment pacing models for any active route. Translates meteorological telemetry to clear headwinds vector arrays.

INPUT SCHEMA:

{ "routeId": "string (the Firestore route ID)" }

RETURN VALUE:

[ { "interval_km": 10.0, "wind_speed_kph": 24.5, "wind_direction": "SE", "headwind_component_kph": 18.2 } ]
INTEGRATION EXAMPLES

STANDALONE ROUTING INSTANTLY

Whether scripting custom Raspberry Pi overlays, flashing telemetry screens, or updating local daemon agents, Gravalist supports straightforward integrations using REST or local JSON payloads. Use standard developer SDK packages or plain REST curl triggers.

curl -H "x-api-key: gravalist_dev_key_2026" \
    http://localhost:8080/api/v1/routes
GRAVALIST API PLAYGROUND wifi_tethering
RESPONSE TERMINAL LOG
// Select an endpoint and hit SEND to simulate a sandbox request...
REGIONAL DATA INDEX

GEOGRAPHIC ENDPOINT AVAILABILITY

Our weather pacing algorithms and telemetry schemas are actively cached for major unsupported routes in both hemispheres.

SOUTH AFRICA (SOUTH)
  • • Ceres Karoo Base Loop (508km)
  • • Sedgefield Forest Explorer (320km)
  • • Franschhoek Pass Pacing Profile
UNITED STATES
  • • Colorado Trail CTR (840km)
  • • Oregon Timber Grand Depart
  • • Midwest Mountain Ridge Loop
EUROPE / ITALY
  • • Bormio-Stelvio Altitude Pacing
  • • Abruzzo Wolf Lair Terrain Segment
  • • Alps Divide Rally Vector Maps

GET A FREE KEY TODAY

Connect your automated agents, cursor systems, and personal head-units out-of-band. Integrate once, explore indefinitely.

Get Access Token