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., "@Gravalist-MCP find gravel routes with micro-elevation maps near Boulder"
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.
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.
Related MCP server: BikeScout
To interact with the Gravalist MCP Server, you will need to authenticate your requests using a Developer API Key. Follow these 3 steps to start querying telemetry:
All developers must have an active rider profile.
Navigate to app.gravalist.com.
Sign up or log in to your account.
To protect system resources and cap telemetry usage, you must generate a secure access token.
Log into the Gravalist web app and navigate to your Profile.
Click Generate API Token.
Copy this secure x-api-key (you will not be able to view it again).
Note: Test tokens are subject to rate limiting and monthly quota caps. If you require higher limits for production use cases, please contact our support team.
Pass your secure access token inside the x-api-key headers to start streaming granular route geometries or invoking tools.
curl -H "x-api-key: YOUR_GENERATED_API_KEY" http://localhost:8080/api/v1/routescurl http://localhost:8080/mcp/manifestIf you want to run the standalone telemetry server locally:
Clone the repository:
git clone https://github.com/Collective-Social/Gravalist-MCP.git
cd Gravalist-MCPInstall dependencies:
npm installRun the server:
npm startThe server will start on port 8080.
GET /api/v1/routesRetrieves a rich listing of premium gravel routes containing micro-elevation data and safety sector mappings.
GET /api/v1/routes/:id/weatherRetrieves pre-computed, debounced predictive wind, rain, and temperature pacing intervals mapped to the specific route ID.
GET /mcp/manifestRetrieves the official Model Context Protocol (MCP) server JSON manifest, defining active tools for LLM agent integration.
This server cannot be deployed
Geospatial AI MCP server — satellite imagery, embeddings, weather, GNS governance
Geocoding, routing, isochrones, traffic, weather, and place search for AI agents. 19 MCP tools.
Built-environment forecasts, public benchmarks, and permit or zoning readiness through remote MCP.
Agentic-AI route optimization for delivery fleets, capacity- and time-window-safe.
