DEVELOPER API
Standalone Telemetry & MCP Node
The Power of Decoupled Telemetry
Standard mobile operating systems aggressively restrict background processes, making real-time telemetry computation, caching, and custom routing widgets incredibly difficult to sustain. Gravalist bridges this gap by exposing a completely standalone, read-only developer microservice.
High-End Routes
Query precise, curated 500-Series gravel routes containing micro-elevation maps, grade changes, and surface breakdowns.
Weather Pacing
Retrieve predictive weather forecasts mapped specifically to rider-speed intervals for absolute clarity on wind shifts.
MCP Integration
Integrate our JSON-standard MCP manifest to allow local AI agents to autonomously scout route gaps and identify locked gates.
Getting Started in 3 Steps
Create Profile
Log into app.gravalist.com, navigate to your Profile, and click "Generate API Token" to get your secure access key.
Clone Repository
Fetch the starter kits and local Model Context Protocol node service assets directly from our active GitHub project.
Query Telemetry
Pass your secure access token inside the x-api-key headers to start streaming granular route geometries or invoking tools.
API Endpoints
Retrieves a rich listing of premium gravel routes containing micro-elevation data and safety sector mappings.
curl -H "x-api-key: gravalist_dev_key_2026" http://localhost:8080/api/v1/routes
Retrieves pre-computed, debounced predictive wind, rain, and temperature pacing intervals mapped to the specific route ID.
curl -H "x-api-key: gravalist_dev_key_2026" http://localhost:8080/api/v1/routes/7BMjtSWOAzSLSERCX8wp/weather
Retrieves the official Model Context Protocol (MCP) server JSON manifest, defining active tools for LLM agent integration.
curl http://localhost:8080/mcp/manifest
Status & Host
Go Live. Ride Premium.
Our Developer APIs run out-of-band, but the true Gravalist experience lives on the trail. Download our App Store-approved mobile application to unlock offline vector-tile navigation, live predictive safety wind pacing, and automated SOS pings.